System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
1. Read out the current height of the object and temporarily store it in lHeight.
2. Executing user-defined code for processing return values.
GetHiddenInput example
{
BOOL bHiddenInput;
//Get the state of hidden input
bHiddenInput = GetHiddenInput(lpszPictureName,"IOField1");
if(bHiddenInput)
{
// User defined code if the
// hidden input is activated
...
}
Else
{
// User defined code if the
// hidden input is activated
...
}
}
Parameters of the GetHiddenInput function:
"lpszPictureName" is the name of the picture in which the object was configured.
"IOField1" is the name of the object.
1. Read out whether the text is in bold or not and temporarily store in bHiddenInput.
2. Executing user-defined code, depending on the return value of the function.
GetLanguage example
{
DWORD rt_language;
//Get the current language
rt_language = GetLanguage ();
//User defined code where the
//user can do something with the return value
...
}
1. Read out the current Runtime language and temporarily store it in rt_language.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1481
2. Executing user-defined code for processing return values.
GetLeft example
{
long lPos;
//Get the x-position of the object
lPos = GetLeft(lpszPictureName,"WinCCLogo");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetLeft function:
"lpszPictureName" is the name of the picture in which the object was configured.
"WinCCLogo" is the name of the object.
1. Read out the current X position of the object and temporarily store it in lPos.
2. Executing user-defined code for processing return values.
GetLink example
{
LINKINFO linkinfo;
//Get the linked Tag
GetLink(lpszPictureName,"Bar1","Process",&linkinfo);
// linkinfo.szLinkName is the tag name
// linkinfo.dwCycle is the update cycle
// linkinfo.LinkType is the type of the connection
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetLink function:
"lpszPictureName" is the name of the picture in which the object was configured.
"Bar1" is the name of the object.
"Process" is the property connected to a tag.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1482
System Manual, 11/2008,
"&linkinfo" is the address of the linkinfo structure.
1. Fills the passed linkinfo structure with the tag connection information.
2. Executing user-defined code, depending on the return value of the function.
GetLinkedVariable example
{
char* pszVarName = NULL;
char szVarName[_MAX_PATH+1];
//Get the TagName
pszVarName = GetLinkedVariable("gs_stand_graph_00","StaticText6","Visible");
//Copy the string
if (strcmp (pszVarName,"")!= 0)
{
strncpy(szVarName,pszVarName,_MAX_PATH);
}
else printf("Attribute 'visible' is not made dynamic\r\n");
}
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetLinkedVariable function:
"gs_stand_graph_00" is the name of the picture in which the object was configured.
"StaticText6" is the name of the object.
"Visible" is the property connected to a tag.
1. Temporarily store the return value of the GetLinkedVariable function in pszVarName.
2. If a valid value has been returned, store the return value in szVarName. A maximum of
_MAX_PATH characters is stored.
3. Executing user-defined code for processing return values.
GetLocalPicture example
{
char* pszPicName = NULL;
char szPicName[_MAX_PATH+1];
//Get the Local Picture
pszPicName = GetLocalPicture(lpszPictureName);
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1483
//Copy the string
if (pszPicName != NULL)
{
strncpy(szPicName,pszPicName,_MAX_PATH);
}
//User defined code where the
//user can do something with the return value
...
}
1. Temporarily store the return value of the GetLocalPicture function in pszPicName.
2. If a valid value has been returned, store the return value in szPicName. A maximum of
_MAX_PATH characters is stored.
3. Executing user-defined code for processing return values.
GetMarker example
{
BOOL bmarker;
//Get the state of the Marker
bmarker = GetMarker(lpszPictureName,"Bar1");
if(bmarker)
{
// User defined code if the
// marker is activated
...
}
Else
{
// User defined code if the
// marker is deactivated
...
}
}
Parameters of the GetMarker function:
"lpszPictureName" is the name of the picture in which the object was configured.
"Bar1" is the name of the object.
1. Read out whether the marker is displayed or not and temporarily store in bmarker.
2. Executing user-defined code, depending on the return value of the function.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1484
System Manual, 11/2008,
GetOutputValueDouble example
{
double doutput;
//Get the output value of IO Field 1
doutput = GetOutputValueDouble(lpszPictureName,"IOField1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetOutputValueDouble function:
"lpszPictureName" is the name of the picture in which the object was configured.
"IOField1" is the name of the object.
1. Read out the output value and temporarily store it in doutput.
2. Executing user-defined code for processing return values.
GetParentPicture example
{
char* pszPicName = NULL;
char szPicName[_MAX_PATH+1];
//Get the parent picture
pszPicName = GetParentPicture(lpszPictureName);
//Copy the string
if (pszPicName != NULL)
{
strncpy(szPicName,pszPicName,_MAX_PATH);
}
//User defined code where the
//user can do something with the return value
...
}
1. Temporarily store the return value of the GetParentPicture function in pszPicName.
2. If a valid value has been returned, store the return value in szPicName. A maximum of
_MAX_PATH characters is stored.
3. Executing user-defined code for processing return values.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1485
GetPictureDown example
{
char* pszPicName = NULL;
char szPicName[_MAX_PATH+1];
//Get the current picture name
pszPicName = GetPictureDown(lpszPictureName,"Roundbutton1");
if (pszPicName != NULL)
{
//Copy the string
strncpy(szPicName,pszPicName,_MAX_PATH);
}
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetPictureDown function:
"lpszPictureName" is the name of the picture in which the object was configured.
"RoundButton1" is the name of the object.
1. Read out the picture name of the picture displayed in round button 1 and temporarily store
it in pszPicName.
2. If a valid value has been returned, store the return value of the function in the local string
szPicName. A maximum of _MAX_PATH characters is stored.
3. Executing user-defined code for processing return values.
GetPictureName example
{
char* pszPictureName = NULL;
char szPictureName[_MAX_PATH + 1];
//Get the current PictureName
pszPictureName = GetPictureName(lpszPictureName,"GraphicObject1");
if(pszPictureName != NULL)
{
//copy the string
strncpy(szPictureName,pszPictureName,_MAX_PATH);
}
//User defined code where the
//user can do something with the return value
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1486
System Manual, 11/2008,
...
}
Parameters of the GetPictureName function:
"lpszPictureName" is the name of the picture in which the object was configured.
"GraphicObject1" is the name of the object.
1. Read out the picture name of the picture displayed in graphic object 1 and temporarily store
it in pszPictureName.
2. If a valid value has been returned, store the return value of the function in the local string
szPictureName. A maximum of _MAX_PATH characters is stored.
3. Executing user-defined code for processing return values.
GetPictureUp example
{
char* pszPicName = NULL;
char szPicName[_MAX_PATH+1];
//Get the current picture name
pszPicName = GetPictureUp(lpszPictureName,"Roundbutton1");
if (pszPicName != NULL)
{
//Copy the string
strncpy(szPicName,pszPicName,_MAX_PATH);
}
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetPictureUp function:
"lpszPictureName" is the name of the picture in which the object was configured.
"RoundButton1" is the name of the object.
1. Read out the picture name of the picture displayed in round button 1 and temporarily store
it in pszPicName.
2. If a valid value has been returned, store the return value of the function in the local string
szPicName. A maximum of _MAX_PATH characters is stored.
3. Executing user-defined code for processing return values.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1487
GetPosition example
{
long int lpos;
//Get the actual position of the Slider
lpos = GetPosition(lpszPictureName,"Control1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetPosition function:
"lpszPictureName" is the name of the picture in which the object was configured.
"Control1" is the name of the object.
1. Read out the current slider position and temporarily store it in lpos.
2. Executing user-defined code for processing return values.
GetPropBOOL example
{
BOOL bProp;
//Get the property Visible
bProp = GetPropBOOL("gs_graph_eafield","IOField1","Visible");
if(bProp)
{
// User defined code if the
// object is visible
...
}
else
{
// User defined code if the
// object is not visible
...
}
}
Parameters of the GetVisible function:
"lpszPictureName" is the name of the picture in which the object was configured.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1488
System Manual, 11/2008,
"IOField1" is the name of the object.
"Visible" is the object property.
1. Read out whether the object is visible or not and temporarily store in bProp.
2. Executing user-defined code, depending on the return value of the function.
GetPropChar example
{
char* pszProp = NULL;
char szProp[14];
//Get the property Tooltiptext
pszProp = GetPropChar("lpszPictureName","EAFeld1","Tooltiptext");
if(pszProp != NULL)
{
//Copy the string
strncpy(szProp,pszProp,13);
}
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetPropChar function:
"lpszPictureName" is the name of the picture in which the object was configured.
"IOField1" is the name of the object.
"Tooltiptext" is the object property.
1. Read out the tooltip text of the object and temporarily store it in pszProp.
2. If a valid value has been returned, store the return value of the function in the local string
szProp. A maximum of 13 characters is stored.
3. Executing user-defined code for processing return values.
3.4.1.3 Examples - GetRangeMax to GetWidth
GetRangeMax example
{
long int lrange;
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1489
//Get the upper scale Limit
lrange = GetRangeMax(lpszPictureName,"Control1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetRangeMax function:
"lpszPictureName" is the name of the picture in which the object was configured.
"Control1" is the name of the object.
1. Read out the current upper limit of the object and temporarily store it in lrange.
2. Executing user-defined code for processing return values.
GetRangeMin example
{
long int lrange;
//Get the lower scale Limit
lrange = GetRangeMin(lpszPictureName,"Control1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetRangeMin function:
"lpszPictureName" is the name of the picture in which the object was configured.
"Control1" is the name of the object.
1. Read out the current lower limit of the object and temporarily store it in lrange.
2. Executing user-defined code for processing return values.
Beispiel GetScaling
{
BOOL bscaling;
//Get the Scaling state
bscaling = GetScaling(lpszPictureName,"Bar1");
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1490
System Manual, 11/2008,