System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
"%d%d%s%f%d" are the type descriptions of the tags to be read.
"gs_tag_bit" is the tag to be read.
"&lValue1" is the address of the tags in which the value of the tags gs_tag_bit should be stored.
"gs_tag_SByte" is the tag to be read.
"&lValue2" is the address of the tags in which the value of the tags gs_tag_SByte should be
stored.
The other parameters are to be handled in the same way as those described previously.
1. Creating a DWord-Array with the required size (Number of tags).
2. Reading and storing the values of the tags. The value of the tags gs_tag_bit is stored
temporarily in lValue1. The value of the tags gs_tag_SByte is stored temporarily in lValue2,
etc.
3. Executing user-defined code for processing return values.
GetTagMultiWait example
DWORD dwVar1Value;
char* szVar2Value;
//Memory for the tag value is
//created by teh function with SysMalloc
double dbVar3Value;
BOOL ok;
ok=GetTagMultiWait("%d%s%f", "Ernie_word", &dwVar1Value,
"Ernie_char", &szVar2Value,
"Ernie_double", &dbVar3Value);
printf("Word %d, String %s, Double %f\r\n",
dwVar1Value, szVar2Value, dbVar3Value);
GetTagPrefix example
{
char* pszTagPrefix = NULL;
char szTagPrefix[7];
//Get the current tag prefix
pszTagPrefix = GetTagPrefix(lpszPictureName,"PicWindow1");
if(pszTagPrefix != NULL)
{
//Copy the string
strncpy(szTagPrefix,pszTagPrefix,6);
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1501
}
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagPrefix function:
"lpszPictureName" is the name of the picture in which the object was configured.
"PictureWindow1" is the name of the object.
1. Read out the current tag prefix of picture window 1 and temporarily store it in pszTagPrefix.
2. If a valid value has been returned, store the return value of the function in the local string
szTagPrefix. A maximum of 6 characters is stored.
3. Executing user-defined code for processing return values.
GetTagRaw example
{
#define DATA_SIZE 3
BYTE byData[DATA_SIZE];
//Get the current values of the tag
GetTagRaw("gs_tag_raw",byData,DATA_SIZE);
//Use the values received in the array byData
...
}
Parameters of the GetTagRaw function:
"gs_tag_raw" is the name of the tag.
"byData" is the byte array in which the values of the raw data tags will be stored.
"DATA_SIZE" is the number of values that will be read.
1. Reading the values of the tags and temporarily storing in byData.
2. Executing user-defined code for processing return values.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1502
System Manual, 11/2008,
GetTagRawStateQCWait example
{
#define DATA_SIZE 3
DWORD dwState;
DWORD dwQC;
BYTE byData[DATA_SIZE];
dwState = 0xFFFFFFFF;
//Get the values of the tag
GetTagRawStateQCWait("gs_tag_raw",byData,DATA_SIZE,&dwState,&dwQC);
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagRawStateQCWait function:
"gs_tag_raw" is the name of the tag.
"byData" is the byte array in which the values of the raw data tags will be stored.
"DATA_SIZE" is the number of values that will be read.
"&dwState" is the address of the tags in which the tag status is to be stored.
"&dwQC" is the address of the tag in which the quality code is to be stored.
1. Reading the values of the tags and temporarily storing in byData.
2. Executing user-defined code for processing return values.
GetTagRawStateWait example
{
#define DATA_SIZE 3
DWORD dwstate;
BYTE byData[DATA_SIZE];
char szValue[11];
//Load dwState with default values
dwstate = 0xFFFFFFFF;
//Get the values of the tag
//dwstate is the tag state
GetTagRawStateWait("gs_tag_raw",byData,DATA_SIZE,&dwstate);
//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)
System Manual, 11/2008,
1503
}
Parameters of the GetTagRawStateWait function:
"gs_tag_raw" is the name of the tag.
"byData" is the byte array in which the values of the raw data tags will be stored.
"DATA_SIZE" is the number of values that will be read.
"&dwstate" is the address of the tags in which the tag status is to be stored.
1. Reading the values of the tags and temporarily storing in byData.
2. Executing user-defined code for processing return values.
GetTagSByte example
{
long lValue;
//Get the current value of the tag
lValue = GetTagSByte("gs_tag_SByte");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagSByte function:
"gs_tag_SByte" is the name of the tag.
1. Read the value of the tag and temporarily store it in lValue.
2. Executing user-defined code for processing return values.
GetTagSByteStateQCWait example
{
DWORD dwState;
DWORD dwQC;
long lValue;
dwState = 0xFFFFFFFF;
//Get the tag value
lValue = GetTagSByteStateQCWait("gs_tag_SByte",&dwState, &dwQC);
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1504
System Manual, 11/2008,
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagSByteStateQCWait function:
"gs_tag_SByte" is the name of the tag.
"&dwState" is the address of the tags in which the tag status is to be stored.
"&dwQC" is the address of the tag in which the quality code is to be stored.
1. Read the value of the tag and temporarily store it in lValue. The function puts the tag status
in dwState and the quality code in dwQC.
2. Executing user-defined code for processing return values.
GetTagSByteStateWait example
{
DWORD dwstate;
long lValue;
dwstate = 0xFFFFFFFF;
//Get the tag value
//dwstate is the tag state
lValue = GetTagSByteStateWait("gs_tag_SByte",&dwstate);
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagSByteStateWait function:
"gs_tag_SByte" is the name of the tag.
"&dwstate" is the address of the tags in which the tag status is to be stored.
1. Read the value of the tag and temporarily store it in lValue. The function puts the tag status
in dwstate.
2. Executing user-defined code for processing return values.
GetTagWord example
{
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1505
WORD wValue;
//Get the current value of the tag
wValue = GetTagWord("gs_tag_word");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagWord function:
"gs_tag_word" is the name of the tag.
1. Read out the value of the tag and temporarily store it in wValue.
2. Executing user-defined code for processing return values.
GetTagWordStateQCWait example
{
DWORD dwState;
DWORD dwQC;
WORD wValue;
dwState = 0xFFFFFFFF;
//Get the tag value
wValue = GetTagWordStateQCWait("gs_tag_word",&dwState, &dwQC);
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagWordStateQCWait function:
"gs_tag_word" is the name of the tag.
"&dwState" is the address of the tags in which the tag status is to be stored.
"&dwQC" is the address of the tag in which the quality code is to be stored.
1. Read out the value of the tag and temporarily store it in wValue. The function puts the tag
status in dwState and the quality code in dwQC.
2. Executing user-defined code for processing return values.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1506
System Manual, 11/2008,
GetTagWordStateWait example
{
DWORD dwstate;
WORD wValue;
dwstate = 0xFFFFFFFF;
//Get the tag value
//dwstate is the tag state
wValue = GetTagWordStateWait("gs_tag_word",&dwstate);
//User defined code where the
//user can do something with the return value
...
}
Parameters of then GetTagWordStateWait function:
"gs_tag_word" is the name of the tag.
"&dwstate" is the address of the tags in which the tag status is to be stored.
1. Read out the value of the tag and temporarily store it in wValue. The function puts the tag
status in dwstate.
2. Executing user-defined code for processing return values.
GetText example
{
char* pszValue = NULL;
char szValue[13];
//Get the Text which is actually set
pszValue = GetText(lpszPictureName,"StaticText1");
if(pszValue != NULL)
{
//Copy the string
strncpy(szValue,pszValue,12);
}
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetText function:
"lpszPictureName" is the name of the picture in which the object was configured.
"StaticText1" is the name of the object.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1507
1. Read out the text in the object StaticText1 and temporarily store it 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 12 characters is stored.
3. Executing user-defined code for processing return values.
GetTop example
{
long lPos;
//Get the y-Position of the Object
lPos = GetTop(lpszPictureName,"WinCCLogo");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTop 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 Y position of the object and temporarily store it in lPos.
2. Executing user-defined code for processing return values.
GetVisible example
{
BOOL bVisible;
//Get the visibility
bVisible = GetVisible(lpszPictureName,"GraphicObject1");
if(bVisible)
{
// User defined code if the
// object is visible
...
}
else
{
// User defined code if the
// object is not visible
...
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1508
System Manual, 11/2008,
}
}
Parameters of the GetVisible function:
"lpszPictureName" is the name of the picture in which the object was configured.
"GraphicObject1" is the name of the object.
1. Read out whether the object is visible or not and temporarily store in bVisible.
2. Executing user-defined code, depending on the return value of the function.
GetWidth example
{
long lWidth;
//Get the width of the object
lWidth = GetWidth(lpszPictureName,"WinCCLogo");
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetWidth 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 width of the object and temporarily store it in lWidth.
2. Executing user-defined code for processing return values.
3.4.1.4 Examples - H to S
InquireLanguage example
{
DWORD count;
DWORD* language;
int i;
//Count the installed languages
language = InquireLanguage(&count);
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1509
printf("##################### INQUIRE LANGUAGE ####################");
//Print out the count of languages
printf ( "\r\nCount Languages=%d\r\n", count );
//print out which languages are installed
for (i=1;i<=count; i++)
{
printf ("\r\n%d.language=%x", i,*language++);
}
}
1. Determine the languages configured for the runtime. In language the language IDs are
temporarily stored. In count the number of languages is temporarily stored.
2. The number of determined languages is output.
3. All determined language IDs are displayed.
ProgramExecute example
{
//start the program calc.exe
ProgramExecute("C:\\Winnt\\system32\\calc.exe");
}
As parameter the file is to be specified with its path.
ResetFilter example
{
BOOL ret;
MSG_FILTER_STRUCT Filter;
CMN_ERROR Error;
//delete the whole Filter struct
memset( &Filter, 0, sizeof( MSG_FILTER_STRUCT ) );
//set an empty filter struct
AXC_SetFilter("gs_alarm_00","Control1",&Filter,&Error);
}
1. Delete the filter structure.
2. Write empty values into the filter structure.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1510
System Manual, 11/2008,