System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
long int columns
//get number of Columns
columns = GetNumberOfColumns("TableControl_01");
//convert long int to char
sprintf(text,"%d",columns);
//set text on TextField5
SetText(lpszPictureName,"StaticText5",text);
}
Parameters of the TlgGetNumberOfColumns function:
"TableControl_01" is the name of the WinCC Table Control.
1. Temporarily store the return value of the TlgGetNumberofColumns in columns.
2. Temporarily store the return value in the text string.
3. Output the return value to a static text field.
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.
TlgGetNumberOfColumns example
{
char text[5];
long int columns
//get number of Columns
columns = GetNumberOfColumns("TableControl_01");
//convert long int to char
sprintf(text,"%d",columns);
//set text on TextField5
SetText(lpszPictureName,"StaticText5",text);
}
Parameters of the TlgGetNumberOfColumns function:
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1531
"TableControl_01" is the name of the WinCC Table Control.
1. Temporarily store the return value of the TlgGetNumberofColumns in columns.
2. Temporarily store the return value in the text string.
3. Output the return value to a static text field.
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.
TlgGetNumberOfRows example
{
char text[5];
long int rows;
//get number of rows
rows = TlgGetNumberOfRows("TableControl_01");
//convert long int to char
sprintf(text,"%d",rows);
//set text on TextField5
SetText(lpszPictureName,"StaticText5",text);
}
Parameters of the TlgGetNumberOfRows function:
TableControl_01 is the name of the WinCC Table Control.
1. Temporarily store the return value of the TlgGetNumberofRows in rows.
2. Temporarily store the return value in the text string.
3. Output the return value to a static text field.
TlgGetRulerTimeTrend example
{
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1532
System Manual, 11/2008,
SYSTEMTIME systime;
WORD wHour;
WORD wMin;
WORD wSec;
char szTime[10];
//Get the current systemtime
systime = TlgGetRulerTimeTrend("TrendControl_01",0);
//Get the hour
wHour = systime.wHour;
//Get the minute
wMin = systime.wMinute;
//Get the second
wSec = systime.wSecond;
//
sprintf(szTime,"%d:%d:%d",wHour,wMin,wSec);
//output the variable name
SetText(lpszPictureName,"StaticText7",szTime);
}
1. Read out the current system time.
2. Read out hour, minute and second from the SYSTEMTIME structure.
3. Create a string containing the time.
4. Output the current time.
TlgGetRulerVariableNameTrend example
{
char* pszVarName = NULL;
char szVarName[20];
//Get the ruler variable name
pszVarName = TlgGetRulerVariableNameTrend("TrendControl_01",0);
if (pszVarName != NULL)
{
//Copy the string
strncpy(szVarName,pszVarName,19);
}
//output the variable name
SetText(lpszPictureName,"StaticText6",szVarName);
}
Parameters of the TlgGetRulerVariableNameTrend function:
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1533
"TrendControl_01" is the name of the WinCC Trend Control.
"0" is the number of the trend.
1. Temporarily store the return value of the TlgGetRulerVariableNameTrend function in
pszVarName.
2. If a valid value has been returned, copy the return value to szVarName.
3. Output the return value to a static text field.
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.
TlgTrendWindowPressOpenDlgButton example
{
//Opens the Property Dialog
TlgTrendWindowPressOpenDlgButton("TrendControl_01");
}
Parameters of the TlgTrendWindowPressOpenDlgButton function:
"TrendControl_01" is the window title of WinCC Trend Control.
TlgTrendWindowPressStartStopButton example
{
//start/stop the actualization
TlgTrendWindowPressStartStopButton("TrendControl_01");
}
Parameters of the TlgTrendWindowPressStartStopButton function:
"TrendControl_01" is the window title of WinCC Trend Control.
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.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1534
System Manual, 11/2008,
TlgTrendWindowPressZoomInButton example
{
//zoom in
TlgTrendWindowPressZoomInButton("TrendControl_01");
}
Parameters of the TlgTrendWindowPressZoomInButton function:
"TrendControl_01" is the window title of WinCC Trend Control.
TlgTrendWindowPressZoomOutButton example
{
// zoom out
TlgTrendWindowPressZoomOutButton("TrendControl_01");
}
Parameters of the TlgTrendWindowPressZoomOutButton function:
"TrendControl_01" is the window title of WinCC Trend Control.
3.4.2 Lists
3.4.2.1 Bar direction
Bar direction Numeric value
Up 0
bottom 1
left 2
right 3
3.4.2.2 Bar Scaling
Numeric
value
Bar Scaling
0 Linear (same weighting)
1 Logarithmic (low values emphasized)
2 Negative logarithmic (high values emphasized)
3 Automatic (linear)
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1535
Numeric
value
Bar Scaling
4 Tangential (high and low values emphasized)
5 Square (high values emphasized)
6 Cubic (high values strongly emphasized)
3.4.2.3 Flash frequencies
Numeric
value
Flash frequency
0 0.5 Hz
1 2 Hz
2 8 Hz
Note
Since the flashing is performed by means of software engineering, the flash frequency is both
system-dependent and hardware-bound (number of objects, processor speed, RAM size,
update time etc.).
The information in the table is therefore only for orientation purposes.
3.4.2.4 I/O field, output format
The display of numeric values output into an I/O field is controlled by a format specification.
A format indication consists of one or several formatting characters. The valid formatting
characters and their meaning are listed in the following table:
Charact
ers
Meaning Note
s Positive numbers are displayed
with signs
Always in the first position of the format
specification
May only appear once in the format specification
0(ZER
O)
Leading and ending zeros are
output.
Always following s
If s is missing, it is in the first position
May only appear once in the format specification
9 Specifies the position of a digit in
the number to be output
May appear in the format indication as often as required.
,
(comm
a)
Position of the decimal point
e Returns the number in exponential
form
Always at the last position of the format specification
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1536
System Manual, 11/2008,
Example:
Numb
er
Format Representation
123,4
55
999,999 123,455
123,4
55
999,99 123,46
123,4
55
9999,9999 123,4550
123,4
55
s09999.99
99
+0123,4550
123,4
55
9.99999e 1.23455e+002
If the decimal point is left out in the format specification the decimal places are not displayed
and the number is rounded to an integer.
If fewer decimal positions are provided in the format specification than the number actually
has, only the decimal places specified in the format specification are output.
The number is rounded correspondingly.
If the number has more places before the decimal point than specified in the format
specification,
three asterisks (***) are output which means that the number cannot be displayed
in this format.
3.4.2.5 I/O field, data type of the field content
Data type Numeric value
Binary 0
decimal 1
string 2
hexadeci
mal
3
3.4.2.6 I/O field, field type
Type Numeric value
Edition 0
Input 1
Output and
input
2
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1537
3.4.2.7 Element alignment in check boxes and radio boxes
Alignment Numeric value
left 0
right -1
3.4.2.8 Color chart
The 16 primary colors are:
Color Color value
(Hex)
symbolic constant
Red 0x000000F
F
CO_RED
Dark red 0x00000080 CO_DKRED
Green 0x0000FF0
0
CO_GREEN
Dark green 0x00008000 CO_DKGREEN
Blue 0x00FF000
0
CO_BLUE
Dark blue 0x00800000 CO_DKBLUE
Cyan 0x00FFFF0
0
CO_CYAN
Dark cyan 0x00808000 CO_DKCYAN
Yellow 0x0000FFF
F
CO_YELLOW
Dark yellow 0x00008080 CO_DKYELLOW
Magenta 0x00FF00F
F
CO_MAGENTA
Dark magenta 0x00800080 CO_DKMAGENTA
Light gray 0x00C0C0C
0
CO_LTGRAY
Gray 0x00808080 CO_DKGRAY
Black 0x00000000 CO_BLACK
White 0x00FFFFF
F
CO_WHITE
Note
The symbolic constants are externally predefined by #define and provied by WinCC.
3.4.2.9 Format descriptors
For format descriptors the following type is expected:
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1538
System Manual, 11/2008,
%d = DWORD / Int
%f = double
%s = char*
It is also possible e.g. to read a text tag with %d if provisions are made that the value can be
mapped in a DWORD.
The following provision makes sure the value can be mapped:
Variab
le
Form
at
C-tag
Bit %d DWORD / long int signed
Byte %d DWORD / long int signed
SByte %d DWORD / long int signed
Word %d DWORD / long int signed
SWor
d
%d DWORD / long int signed
DWor
d
%d DWORD / long int signed
SDWo
rd
%d DWORD / long int signed
Float %f double
Doubl
e
%f double
Char %s char*
Note
If a "DWORD," for which the 32nd bit is set, is to be read, a format descriptor must be used
for unsigned integers (%u).
3.4.2.10 Fill pattern
Fill pattern Value
Transparent 65536
Solid 0
Fill pattern Value Fill pattern Value Fill pattern Value
1048576 196611 196627
1048577 196612 196628
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1539
Fill pattern Value Fill pattern Value Fill pattern Value
1048578 196613 196629
1048579 196614 196630
1048832 196615 196631
1048833 196616 196632
1048834 196617 196633
1048835 196618 196634
131072 196619 196635
131073 196620 196636
131074 196621 196637
131075 196622 196638
131076 196623 196639
196608 196624 196640
196609 196625 196641
196610 196626 196642
Note
The "Solid" fill pattern fills the object with the set background color.
ANSI-C function descriptions
3.4 Appendix
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1540
System Manual, 11/2008,