System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
lpszObjectName
Object name
lSmallChange
Number of setting steps
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
SetTagPrefix
Function
This function sets the tag prefix of a picture window:
In a picture window the "temperature" tag is requested on an object. If a "Motor1." tag prefix
is assigned to the picture window, the tag "Motor1.Temperature" is requested.
The setting of the tag prefix only becomes effective when newly supplying the picture name.
This means you must either set the prefix before picture selection or newly supply the picture
name if the picture is not changed.
Syntax
BOOL SetTagPrefix(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName,char*
szTagPrefix);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1311
szTagPrefix
Tag prefix to be set
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
Note
If the tag prefix is set for a picture window, the tag prefix is added to all tags contained in the
picture
to be displayed. This also applies if the request takes place in a function. If a tag needs
to be read without the tag prefix, you must add "@NOTP::" to the tag name.
Using a tag prefix greatly simplifies the picture module technology.
See also
SetTagPrefix example (Page 1526)
SetTrend
Function
Controls the trend display for bar objects.
Syntax
BOOL SetTrend(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL bTrend);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1312
System Manual, 11/2008,
bTrend
Trend display yes/no
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
See also
SetVisible example (Page 1530)
SetVisible
Function
Controls the display of an object.
Syntax
BOOL SetVisible(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, BOOL bVisible);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
bVisible
Object display yes/no
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1313
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
Note
If the function is called in relation to the entire picture, set the parameter lpszObjectName =
NULL.
See also
SetVisible example (Page 1530)
SetZeroPointValue
Function
Sets the absolute value of the zero point for bar objects.
Syntax
BOOL SetZeroPointValue(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, double
dZeroPointValue);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
dZeroPointValue
Absolute value of the zero point
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1314
System Manual, 11/2008,
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
SetZoom
Function
Sets the scaling factor for a picture window.
Syntax
BOOL SetZoom(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int lZoom);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
lZoom
Scaling factor
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1315
ole_control
OLE_control - short description
The functions in the ole_Control group can only be used with OCX slider objects.
Various OCX slider object properties and settings can be modified or called in using these
functions.
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.
SetPosition
Function
Sets the slider position of the OCX slider object.
Syntax
BOOL SetPosition(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int
lPosition);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
lPosition
Slider position of the OCX slider object
Return value
TRUE
The function has been completed without any errors.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1316
System Manual, 11/2008,
FALSE
An error has occurred.
See also
SetPosition example (Page 1520)
SetRangeMax
Function
Defines the adjustment range "Max" of the OCX slider object.
Syntax
BOOL SetRangeMax(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int
lRangeMax);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
lRangeMax
Adjustment range "Max" of the OCX slider object
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1317
See also
SetRangeMax example (Page 1521)
SetRangeMin
Function
Defines the adjustment range "Min" of the OCX slider object.
Syntax
BOOL SetRangeMin(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, long int
lRangeMin);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
lRangeMin
Adjustment range "Min" of the OCX slider object
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
See also
SetRangeMin example (Page 1521)
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1318
System Manual, 11/2008,
pictures
Pictures - short description
Various properties of pictures of graphic objects and round buttons can be modified or called
in using the functions in the Pictures group.
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.
SetPicDeactTransparent
Function
Sets the transparent color for the "deactivated" status of a round button.
Syntax
BOOL SetPicDeactTransparent(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName,
long int lPicDeactTransparent);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
lPicDeactTransparent
Transparent color for "deactivated" status
Return value
TRUE
The function has been completed without any errors.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1319
FALSE
An error has occurred.
Note
This function only applies to Bitmap graphics (*.bmp).
See also
Color chart (Page 1538)
SetBackColor example (Page 1512)
SetPicDeactUseTransColor
Function
Controls the transparent color for the "deactivated" status of a round button.
Syntax
BOOL SetPicDeactUseTransColor(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName,
BOOL bPicDeactUseTransColor);
Parameter
lpszPictureName
Picture name
lpszObjectName
Object name
bPicDeactUseTransColor
Transparent color yes/no
Return value
TRUE
The function has been completed without any errors.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1320
System Manual, 11/2008,