System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
if (bscaling)
{
// User defined code if the
// bar object has an additional scale
...
}
Else
{
// User defined code if the
// bar object has no additional scale
...
}
}
Parameters of the GetScaling 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 scale of the bar is displayed or not and temporarily store in bscaling.
2. Executing user-defined code, depending on the return value of the function.
GetServerTagPrefix example
{
char* pszServerPrefix;
char* pszTagPrefix;
char* pszWindowPrefix;
int nServerPrefixLen = 0;
int nTagPrefixLen = 0;
int nTagLen = 0;
char myTagName[MAX_DM_VAR_NAME+1];
//Initialize the return value
memset(myTagName,0,MAX_DM_VAR_NAME + 1);
//Get the serverprefix the tagprefix and the windowprefix
GetServerTagPrefix(&pszServerPrefix, &pszTagPrefix, &pszWindowPrefix);
//If a serverprefix exists
if (pszServerPrefix)
{
//Get the length of the string
nServerPrefixLen = strlen(pszServerPrefix);
}
Else
{
printf("No server prefix was returned.");
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1491
return;
}
//If a tagprefix exists
if (pszTagPrefix)
{
//Get the length of the string
nTagPrefixLen = strlen(pszTagPrefix);
}
//Get the length of the tag
nTagLen = strlen("TagName");
//Check if the lenght of the
//ServerPrefix+TagPrefix+VarName + the double points < MAX_DM_VAR_NAME)
if (nServerPrefixLen + nTagPrefixLen + nTagLen+2 < MAX_DM_VAR_NAME)
{
sprintf(myTagName,"%s::%s%s",pszServerPrefix,pszTagPrefix,"TagName");
//User defined code where the
//user can do something with the return value
...
}
Else
{
printf("The resulting string is too long.");
return;
}
}
1. Initialize the myTagName tag.
2. Read out the server prefix, the tag prefix and the window prefix.
3. If no server prefix has been returned, a text ist output and the function is terminated.
4. If a server prefix has been returned, determine its length and temporarily store it in
nServerPrefixLen.
5. If a tag prefix has been returned, determine its length and temporarily store it in TagPrefixLen.
6. Determine the length of the tag name and temporarily store it in nVarLen.
7. If the length permitted for tag names is exceeded a text is output and the function is
terminated.
8. If the length permitted for tag names is not exceeded, the tag name required for a client
environment is compiled.
9. Executing user-defined code for processing return values.
GetServerTagPrefix example
{
char* pszServerPrefix;
char* pszTagPrefix;
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1492
System Manual, 11/2008,
char* pszWindowPrefix;
//Get the serverprefix and the tagprefix
GetServerTagPrefix(&pszServerPrefix, &pszTagPrefix, &pszWindowPrefix);
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetServerTagPrefix function:
"pszServerPrefix" is the tag which is written into the server prefix.
"pszTagPrefix" is the tag which is written into the tag prefix.
"pszWindowrPrefix" is the tag which is written into the window prefix.
1. Read out the server prefix, the tag prefix and the window prefix.
2. The pszServerPrefix tag contains the returned server prefix.
3. The pszTagPrefix tag contains the returned tag prefix.
4. The pszWindowPrefix tag contains the returned window prefix.
5. Executing user-defined code for processing return values.
GetTagBit example
{
BOOL bstate;
//Get the current state of the tag
bstate = GetTagBit("gs_tag_bit");
if(bstate)
{
// User defined code if the
// value of the tag is true
...
}
else
{
// User defined code if the
// value of the tag is false
...
}
}
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1493
Parameters of the GetTagBit function
"gs_tag_bit" is the name of the tag.
1. Read out the value of the tag and temporarily store it in bstate.
2. Executing user-defined code, depending on the return value of the function.
GetTagBitStateQC example
{
DWORD dwState;
DWORD dwQC;
BOOL bValue;
dwState = 0xFFFFFFFF;
//Get the tag value
//dwstate is the tag state
bValue = GetTagBitStateQCWait("gs_tag_bit",&dwState,&dwQC);
//Create a string which includes the tag value
if (bValue)
{
// User defined code if the
// value of the tag is true
...
}
else
{
// User defined code if the
// value of the tag is false
...
}
}
Parameters of the GetTagBitStateQC function:
"gs_tag_bit" 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 bValue. The function puts the tag
status in dwState and the quality code in dwQC.
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)
1494
System Manual, 11/2008,
GetTagBitStateWait example
{
DWORD dwstate;
BOOL bValue;
dwstate = 0xFFFFFFFF;
//Get the tag value
//dwstate is the tag state
bValue = GetTagBitStateWait("gs_tag_bit",&dwstate);
//Create a string which includes the tag value
if (bValue)
{
// User defined code if the
// value of the tag is true
...
}
else
{
// User defined code if the
// value of the tag is false
...
}
}
Parameters of the GetTagBitStateWait function:
"gs_tag_bit" 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 bstate. The function puts the tag
status in dwstate.
2. Executing user-defined code, depending on the return value of the function.
GetTagChar example
{
char* pszValue = NULL;
char szValue[13];
//Get the current value of the tag
pszValue = GetTagChar("gs_tag_char");
if(pszValue != NULL)
{
//Copy the string
strncpy(szValue,pszValue,12);
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1495
}
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagChar function:
"gs_tag_char" is the name of the tag.
1. Reading the value of the tag and temporarily storing 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.
GetTagCharStateQCWait example
{
DWORD dwState;
DWORD dwQC;
char* pszRetValue = NULL;
char szRetValue[13];
dwState = 0xFFFFFFFF;
//Get the tag value
pszRetValue = GetTagCharStateQCWait("gs_tag_char",&dwState, &dwQC);
if (pszRetValue != NULL)
{
//Copy the string
strncpy(szRetValue,pszRetValue,12);
}
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagCharStateQCWait function:
"gs_tag_char" 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 pszRetValue. The function puts the
tag status in dwState and the quality code in dwQC.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1496
System Manual, 11/2008,
2. If a valid value has been returned, store the return value of the function in the local string
szRetValue. A maximum of 12 characters is stored.
3. Executing user-defined code for processing return values.
Beispiel GetTagCharStateWait
{
DWORD dwstate;
char szValue[11];
char* pszRetValue = NULL;
char szRetValue[13];
dwstate = 0xFFFFFFFF;
//Get the tag value
//dwstate is the tag state
pszRetValue = GetTagCharStateWait("gs_tag_char",&dwstate);
if (pszRetValue != NULL)
{
//Copy the string
strncpy(szRetValue,pszRetValue,12);
}
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagCharStateWait function:
"gs_tag_char" 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 pszRetValue. The function puts the
tag status in dwstate.
2. If a valid value has been returned, store the return value of the function in the local string
szRetValue. A maximum of 12 characters is stored.
3. Executing user-defined code for processing return values.
GetTagFloat example
{
float fValue;
//Get the current value of the tag
fValue = GetTagFloat("gs_tag_float");
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1497
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagFloat function:
"gs_tag_float" is the name of the tag.
1. Read out the value of the tag and temporarily store it in fValue.
2. Executing user-defined code for processing return values.
GetTagFloatStateQCWait example
{
DWORD dwState;
DWORD dwQC;
float fValue;
dwState = 0xFFFFFFFF;
//Get the tag value
fValue = GetTagFloatStateQCWait("gs_tag_float",&dwState, &dwQC);
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagFloatStateQCWait function:
"gs_tag_float" 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 fValue. The function puts the tag
status in dwState and the quality code in dwQC.
2. Executing user-defined code for processing return values.
GetTagFloatStateWait example
{
DWORD dwstate;
float fValue;
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1498
System Manual, 11/2008,
dwstate = 0xFFFFFFFF;
//Get the tag value
//dwstate is the tag state
fValue = GetTagFloatStateWait("gs_tag_float",&dwstate);
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagFloatStateWait function:
"gs_tag_float" 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 fValue. The function puts the tag
status in dwstate.
2. Executing user-defined code for processing return values.
GetTagMultiStateQCWait example
{
#define DATA_SIZE 5
DWORD dwState[DATA_SIZE];
DWORD dwQC[DATA_SIZE];
//define all Datas
BOOL lValue1;
long lValue2 ;
char* szValue3;
double dblValue4 ;
WORD lValue5 ;
//Set the tags
GetTagMultiStateQCWait(dwState,dwQC,"%d%d%s%f%d",
"gs_tag_bit",&lValue1,
"gs_tag_SByte",&lValue2,
"gs_tag_char",&szValue3,
"gs_tag_float",&dblValue4,
"gs_tag_word",&lValue5);
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagMultiStateWait function:
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1499
"dwState" is the DWord-Array, in which the tag statuses are stored.
"dwQC" is the DWord-Array, in which the quality codes are stored.
"%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.
GetTagMultiStateWait example
{
#define DATA_SIZE 5
DWORD dwData[DATA_SIZE];
//define all Datas
BOOL lValue1;
long lValue2 ;
char* szValue3;
double dblValue4 ;
WORD lValue5 ;
//Set the tags
GetTagMultiStateWait(dwData,"%d%d%s%f%d",
"gs_tag_bit",&lValue1,
"gs_tag_SByte",&lValue2,
"gs_tag_char",&szValue3,
"gs_tag_float",&dblValue4,
"gs_tag_word",&lValue5);
//User defined code where the
//user can do something with the return value
...
}
Parameters of the GetTagMultiStateWait function:
"dwData" is the DWord-Array, in which the tag statuses are stored.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1500
System Manual, 11/2008,