System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Syntax
long int GetOffsetLeft(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
Horizontal picture distance from the left window border for picture windows
GetOffsetTop
Function
Specifies the vertical picture distance from the upper window border for picture windows.
Syntax
long int GetOffsetTop(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
Vertical picture distance from the upper window border for picture windows
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1121
GetOnTop
Function
Specifies for picture or application windows whether the window is always in the foreground.
Syntax
BOOL GetOnTop(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
TRUE
Picture or application window is always in the foreground
FALSE
Picture or application window can be overlapped by other windows.
See also
GetVisible example (Page 1508)
GetOperation
Function
Specifies whether the object can be operated.
Syntax
BOOL GetOperation(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1122
System Manual, 11/2008,
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
TRUE
Object is operable
FALSE
Object is not operable
Note
If the function is called in relation to the entire picture, set the parameter lpszObjectName =
NULL.
See also
GetVisible example (Page 1508)
GetOperationMessage
Function
Specifies for I/O fields, check boxes, radio boxes or sliders whether a message is output
following operation.
Syntax
BOOL GetOperationMessage(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1123
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
TRUE
Upon operation a message is issued
FALSE
Upon operation no message is issued
See also
GetVisible example (Page 1508)
GetOperationReport
Function
Specifies for all objects except application and picture windows and OLE control whether the
reason for the operation is logged.
Syntax
BOOL GetOperationReport(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1124
System Manual, 11/2008,
Return value
TRUE
Reason for the operation is logged.
FALSE
Reason for the operation is not logged.
Note
If the function is called in relation to the entire picture, set the parameter lpszObjectName =
NULL.
See also
GetVisible example (Page 1508)
GetPasswordLevel
Function
Specifies the authorization level for the operation of the object for all objects except application
and picture windows and OLE control.
Syntax
long int GetPasswordLevel(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
Authorization level for the operation of the object
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1125
Note
If the function is called in relation to the entire picture, set the parameter lpszObjectName =
NULL.
GetPictureName
Function
Returns the name of the picture currently displayed in the picture window.
Syntax
char* GetPictureName(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Name of the picture window
Return value
Pointer to the name of the currently displayed picture
Note
If both parameters are NULL, a pointer appears indicating the name of the basic screen.
See also
GetPictureName example (Page 1486)
GetProcess
Function
Specifies the default setting value for the process value to be displayed for bar and slider
objects.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1126
System Manual, 11/2008,
Specifies the selected fields for check boxes and radio boxes.
Syntax
double GetProcess(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
● For bar and slider objects: Default setting value for the process value to be displayed
● For check and radio boxes: In a 32-bit word each field is represented by a bit (field 1
corrsponds to the bit value 0). Selected fields are marked by a set bit. Non-existing are
assigned 0.
GetScrollBars
Function
Specifies for picture windows whether the window has a scroll bar.
Syntax
BOOL GetScrollBars(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
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,
1127
Return value
TRUE
Picture window has a scroll bar
FALSE
Picture window has no scroll bar
See also
GetVisible example (Page 1508)
GetServerName
Function
Specifies the default setting for the process value to be displayed for OLE control and OLE
object.
Syntax
char* GetServerName(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
Name of the object (OLE control and OLE object) under which it is registered in WINDOWS.
See also
GetPictureName example (Page 1486)
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1128
System Manual, 11/2008,
GetSizeable
Function
Specifies for application or picture windows whether the window size can be changed.
Syntax
BOOL GetSizeable(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
TRUE
Application or picture window is sizeable
FALSE
Application or picture window is not sizeable
See also
GetVisible example (Page 1508)
GetSmallChange
Function
Specifies the number of steps for slider objects by which the slider is shifted by a mouse click.
Syntax
long int GetSmallChange(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1129
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
Number of steps by which the slider is shifted by a mouse click
GetTagPrefix
Function
Returns the tag prefix of a picture window.
Syntax
char* GetTagPrefix(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName);
Parameters
lpszPictureName
Picture name
lpszObjectName
Object name
Return value
Tag prefix of the picture window
See also
GetTagPrefix example (Page 1501)
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1130
System Manual, 11/2008,