System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
pszFormat
Output format (according to printf function)
<Parameter>
Value to be reported
Note
The parameterization dialog for this function provides the selection of tags, graphic objects
and pictures.
3.4 Appendix
3.4.1 Examples
3.4.1.1 Examles - A to G
AcknowledgeMessage example
{
//Acknowledge the AlarmLogging message which is selected
AcknowledgeMessage(GetTagWord("U08i_MsgNr"));
}
Specify the message number to be acknowledged. It is read from a tag.
AXC_OnBtnMsgFirst example
{
// jump to the first message in the WinCC Alarm Control
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
Parameters of the AXC_OnBtnMsgFirst function:
"gs_alarm_00" is the name of the picture in which WinCC Alarm Control was configured.
Control1 is the object name of the WinCC Alarm Control.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1471
Note
Various examples are offered for the function descriptions. For functions with a similar syntax,
a
selected function is used as a template in the example. This example must be adapted as
well.
Beispiel AXC_OnBtnMsgLast
{
// jump to the last message in the WinCC Alarm Control
AXC_OnBtnMsgLast("gs_alarm_00","Control1");
}
Parameters of the AXC_OnBtnMsgLast function:
"gs_alarm_00" is the name of the picture in which WinCC Alarm Control was configured.
Control1 is the object name of the WinCC Alarm Control.
AXC_OnBtnScroll example
{
// activate/deactivate the scroll function
AXC_OnBtnScroll("gs_alarm_00","Control1");
}
Parameters of the AXC_OnBtnScroll function:
"gs_alarm_00" is the name of the picture in which WinCC Alarm Control was configured.
Control1 is the object name of the WinCC Alarm Control.
AXC_OnBtnSinglAckn example
{
// acknowledge the active message
AXC_OnBtnSinglAckn("gs_alarm_00","Control1");
}
Parameters of the AXC_OnBtnSinglAckn function:
"gs_alarm_00" is the name of the picture in which WinCC Alarm Control was configured.
Control1 is the object name of the WinCC Alarm Control.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1472
System Manual, 11/2008,
AXC_SetFilter example
{
BOOL ret;
MSG_FILTER_STRUCT Filter;
CMN_ERROR Error;
//Reset the filter struct
memset( &Filter, 0, sizeof( MSG_FILTER_STRUCT ) );
//Set the filter name
strcpy( Filter.szFilterName, "Control1");
// Choose selection elements
Filter.dwFilter = MSG_FILTER_NR_FROM | MSG_FILTER_NR_TO;
// Message number from
Filter.dwMsgNr[0] = 2;
// Message number to
Filter.dwMsgNr[1] = 2;
ret = AXC_SetFilter("gs_alarm_00","Control1",&Filter,&Error);
}
1. Name the filter.
2. Select the filter type.
3. Specify the filter criteria.
4. Set the filter.
Note
The filter type and the filter criteria are to be adapted, all other filter types are described in
the filter structure.
DeactivateRTProject example
{
//deactivate the runtime
DeactivateRTProject ();
}
This function deactivates WinCC Runtime.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1473
ExitWinCC example
{
//exit wincc
ExitWinCC ();
}
This function exits WinCC.
3.4.1.2 Examples - GetAlarmHigh to GetPropChar
GetAlarmHigh example
{
double dAlarmHigh;
//Get the Alarm High Limit
dAlarmHigh = GetAlarmHigh(lpszPictureName,"Bar1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the function GetAlarmHigh:
"lpszPictureName" is the name of the picture in which the object was configured.
"Bar1" is the name of the object.
1. Read out the upper alarm limit and temporarily store it in dAlarmHigh.
2. Executing user-defined code for processing return values.
GetBackColor example
{
long int bk_color;
//Get the background color
bk_color = GetBackColor(lpszPictureName,"StatischerText1");
//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)
1474
System Manual, 11/2008,
Parameters of the function GetBackColor:
"lpszPictureName" is the name of the picture in which the object was configured.
"StaticText1" is the name of the object.
1. Read out the current background color and temporarily store it in bk_color.
2. Executing user-defined code for processing return values.
GetBorderStyle example
{
long int lstyle;
//Get the current border style
lstyle = GetBorderStyle(lpszPictureName,"Rectangle1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the function GetBorderStyle:
"lpszPictureName" is the name of the picture in which the object was configured.
"Rectangle1" is the name of the object.
1. Read out the current line style of the object and temporarily store it in lstyle.
2. Executing user-defined code for processing return values.
GetFilling example
{
BOOL bfilling;
//Get the actual state of dynamic filling
bfilling = GetFilling(lpszPictureName,"Rectangle1");
if(bfilling)
{
// User defined code if the
// dynamic filling is activated
...
}
Else
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1475
{
// User defined code if the
// dynamic filling is deactivated
...
}
}
Parameters of the function GetFilling:
"lpszPictureName" is the name of the picture in which the object was configured.
"Rectangle1" is the name of the object.
1. Read out whether dynamic filling is activated or not and temporary store in bfilling.
2. Executing user-defined code, depending on the return value of the function.
GetFillingIndex example
{
long int filling_index;
//Get the actual filling index of the object
filling_index = GetFillingIndex(lpszPictureName,"Rectangle1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the function GetFillingIndex:
"lpszPictureName" is the name of the picture in which the object was configured.
"Rectangle1" is the name of the object.
1. Read out the current fill level of the object and temporarily store it in filling_index.
2. Executing user-defined code for processing return values.
GetFillStyle example
{
long int lstyle;
//Get the current fill style
lstyle = GetFillStyle(lpszPictureName,"Rectangle1");
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1476
System Manual, 11/2008,
//User defined code where the
//user can do something with the return value
...
}
Parameters of the function GetFillStyle:
"lpszPictureName" is the name of the picture in which the object was configured.
"Rectangle1" is the name of the object.
1. Read out the current fill pattern of the object and temporarily store it in lstyle.
2. Executing user-defined code for processing return values.
GetFlashBackColor example
{
BOOL bflash_col;
//Get if the flashing is on or off
bflash_col = GetFlashBackColor(lpszPictureName,"Group1");
if(bflash_col)
{
// User defined code if the
// flashing is activated
...
}
Else
{
// User defined code if the
// flashing is deactivated
...
}
}
Parameters of the function GetFlashBackColor:
"lpszPictureName" is the name of the picture in which the object was configured.
"Group1" is the name of the object.
1. Read out whether flashing of the background color is activated or not and temporary store
in bflash_col.
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)
System Manual, 11/2008,
1477
GetFlashBackColorOn example
{
long int flashcol_on;
//Get the BackFlashColor
flashcol_on = GetBackFlashColorOn(lpszPictureName,"Group1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetBackFlashColorOn function:
"lpszPictureName" is the name of the picture in which the object was configured.
"Group1" is the name of the object.
1. Read out the background flash color for the "On" status of the obvject and and temporarily
store it in flashcol_on.
2. Executing user-defined code for processing return values.
GetFlashRateFlashPic example
{
long lFlashRate;
//Get the flashrate
lFlashRate = GetFlashRateFlashPic(lpszPictureName,"StatusDisplay1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetFlashRateFlashPic function:
"lpszPictureName" is the name of the picture in which the object was configured.
"Status display1" is the name of the object.
1. Read out the flash frequency of the object and temporarily store it in lFlashRate.
2. Executing user-defined code for processing return values.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1478
System Manual, 11/2008,
GetFocus example
{
char* pszValue = NULL;
char szValue[_MAX_PATH+1];
//Get the Object which has the focus
pszValue = Get_Focus();
//Copy the string
if(pszValue != NULL)
{
strncpy(szValue,pszValue,_MAX_PATH);
}
//User defined code where the
//user can do something with the return value
...
}
1. Read out on which object the focus is and temporarily store in pszValue.
2. If a valid value has been returned, store the return value of the function in the local string
szValue. A maximum of _MAX_PATH characters is stored.
3. Executing user-defined code for processing return values.
GetFontBold example
{
BOOL bbold;
//Get if the text is bold
bbold = GetFontBold(lpszPictureName,"StaticText1");
if(bbold)
{
// User defined code if the
// font is bold
...
}
Else
{
// User defined code if the
// font is not bold
...
}
}
Parameters of the GetBackColor 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)
System Manual, 11/2008,
1479
"StaticText1" is the name of the object.
1. Read out whether the text is in bold or not and temporarily store in bbold.
2. Executing user-defined code, depending on the return value of the function.
GetFontSize example
{
long int fontsize;
//Get the actual Font size
fontsize = GetFontSize(lpszPictureName,"StaticText1");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetFontSize function:
"lpszPictureName" is the name of the picture in which the object was configured.
"StaticText1" is the name of the object.
1. Read out the current font size and temporarily store it in fontsize.
2. Executing user-defined code for processing return values.
GetHeight example
{
long lHeight;
//Get the height of the object
lHeight = GetHeight(lpszPictureName,"WinCCLogo");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetHeight function:
"lpszPictureName" is the name of the picture in which the object was configured.
"WinCCLogo" is the name of the object.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1480
System Manual, 11/2008,