System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Moveable Property
Description
TRUE, when the object can be moved in Runtime. Read only access.
See also
Picture Window (Page 191)
Application Window (Page 186)
ScreenItem Object (Page 134)
Moveable Property
Movable
Defines whether the control can be moved in Runtime.
Value Description
TRUE The control can be moved in Runtime.
FALSE The control cannot be moved in Runtime.
The attribute can be assigned dynamic properties by means of the name Moveable.
MsgCtrlFlags Property
Description
Defines the sorting sequence in Alarm Control. Write/Read access.
● 0: The entries are sorted by the value in the time column and in ascending order, i.e. the
oldest messages are displayed at the top of the message window.
● 1: The entries are sorted by the value in the time column in descending order, i.e. the oldest
messages are displayed at the bottom of the message window. In the case of this value,
the
"AutoScroll" property is automatically deactivated, otherwise the current message could
be moved out of the display area of the message window.
See also
WinCC Alarm Control (before WinCC V7) (Page 265)
ScreenItem Object (Page 134)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
451
MsgFilterSQL Property
Description
Defines an SQL Statement to the selected messages displayed in the message window. Write/
Read access.
See also
WinCC Alarm Control (before WinCC V7) (Page 265)
ScreenItem Object (Page 134)
MsgFilterSQL property
MsgFilterSQL
Defines one or several SQL statements for the custom selection of messages. Multiple user-
defined selections are logically linked by "OR" operation. The SQL statements of
"DefaultMsgFilterSQL" and "MsgFilterSQL" are linked logically by "AND" operation if you
define a default selection by means of "DefaultMsgFilterSQL".
The attribute can be assigned dynamic properties by means of the name MsgFilterSQL.
1.14.4.13 N
Name Property
Description of layer and tag object
Returns the object name. STRING (read only)
● In the case of tags, the name of the tag without server and tag prefix
● In the case of layers, the layer name
Tags
The tag "Name" property is used to address the tag via the tag list. The name of a tag can
contain
a server prefix. In WinCC, tag names are structured according to the following scheme:
<Serverprefix>::<Variablenprefix><Name der Variable>
If the tag name alone is specified, the server prefix and tag prefix are removed from the context
of the picture.
If the tag is specified with a server prefix in the tag name, the tags and server prefix of the
context are ignored and the server prefix included is used.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
452
System Manual, 11/2008,
WinCC Function Trend Control Description
The "Index" property references a trend. "Name" defines the name of the trend.
Description Project Object
Returns the name of the current Runtime project. STRING (read only)
Example:
The following example returns the name of the current Runtime project as Trace:
'VBS160
HMIRuntime.Trace "Name: " & HMIRuntime.ActiveProject.Name & vbNewLine
Description of DataItem Object
Returns the name of the DataItem object.
See also
ActiveProject Property (Page 278)
WinCC Function Trend Control (before WinCC V7) (Page 267)
Tag Object (Page 146)
Ellipse segment (Page 158)
Layer Object (Page 127)
DataItem Object (Page 119)
NeedleColor Property
Description
Defines or returns the color of the pointer. LONG write-read access.
See also
WinCC Gauge Control (Page 243)
ScreenItem Object (Page 134)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
453
NormalColor Property
Description
Defines the color of the normal area of the scale. LONG write-read access.
See also
WinCC Gauge Control (Page 243)
ScreenItem Object (Page 134)
NumberLines Property
Description
Text list
Defines or return the number of lines the text list object should contain. If the amount of
configured text is larger than this value, the selection list receives a vertical scroll bar.
Combobox and list box
Defines or returns for the Combobox and List Box objects the number of entries the object
should contain. You can define a maximum of 100,000 lines.
At the same time, the value of the "Number of rows" attribute specifies the upper limit value
for
the "Index" attribute in the "Font" property group. Changing the value can have the following
effects:
● Increasing the number: New lines are added at the bottom. The standard labeling of the
new filed can be changed using the "Text" attribute in the "Font" property group.
● Reducing the number: All lines are removed for which the value of the "Index" attribute is
higher than the new number.
See also
Text list (Page 210)
ScreenItem Object (Page 134)
NumItems Property
Description
Returns the number of trends or column pairs (visible and invisible) in the window which have
been configured. Write/Read access.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
454
System Manual, 11/2008,
See also
WinCC Online Table Control (before WinCC V7) (Page 269)
WinCC Online Trend Control (before WinCC V7) (Page 271)
WinCC Function Trend Control (before WinCC V7) (Page 267)
ScreenItem Object (Page 134)
1.14.4.14 O
Ob - On
Object Property
Description
If a non-WinCC control is used, it is possible that the properties provided by the control have
the same names as the general ScreenItem properties. In such cases, the ScreenItem
properties have priority. The "hidden" properties of an external control supplier can be
accessed using the additional "object" property.
Example:
Address the properties of an external control supplier as follows:
Control.object.type
If the following form alone is used
Control.type
the properties of the ScreenItem object are used in the case of identical names.
See also
Controls (Page 230)
ScreenItem Object (Page 134)
ObjectName Property
Description
Returns the object name.
● In the case of graphic objects, the object name
● In the case of pictures, the picture name
STRING (read only)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
455
Example:
The following example issues the names of all the objects contained in the picture "NewPDL1":
'VBS80
Dim objScreen
Dim lngIndex
Dim lngAnswer
Dim strName
lngIndex = 1
Set objScreen = HMIRuntime.Screens("NewPDL1")
For lngIndex = 1 To objScreen.ScreenItems.Count
strName = objScreen.ScreenItems.Item(lngIndex).ObjectName
lngAnswer = MsgBox("Name of object " & lngIndex & ": " & strName, vbOKCancel)
If vbCancel = lngAnswer Then Exit For
Next
Pictures
Establish the picture name directly from the "ObjectName" property:
'VBS81
MsgBox "Screenname: " & HMIRuntime.ActiveScreen.ObjectName
See also
Screen Object (Page 140)
ScreenItem Object (Page 134)
ObjectSizeDeclutteringEnable Property
Description
Returns the ObjectSizeDecluttering properties of a picture.
Upon activated ObjectSizeDecluttering, only objects within a set size range are displayed.
You specify the upper and lower limits for the display range in Graphics Designer under "Tools>
Settings > Show/Hide".
BOOLEAN Read-only access.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
456
System Manual, 11/2008,
Example:
The example outputs the Decluttering Properties of the picture NewPDL1 as a trace.
'VBS157
Dim objScreen
Set objScreen = HMIRuntime.Screens("NewPDL1")
HMIRuntime.Trace "Min: " & objScreen.ObjectSizeDeclutteringMin & vbNewLine
HMIRuntime.Trace "Max: " & objScreen.ObjectSizeDeclutteringMax & vbNewLine
HMIRuntime.Trace "Enable: " & objScreen.LayerDeclutteringEnable & vbNewLine
See also
Screen Object (Page 140)
ObjectSizeDeclutteringMax Property
Description
Using the ObjectSizeDeclutteringMax property, the upper size range of a picture may be read.
Objects which are larger than the stated pixel size are no longer displayed when
ObjectSizeDecluttering is activated.
LONG read-only access.
Example:
The example outputs the Decluttering Properties of the picture NewPDL1 as a trace.
'VBS157
Dim objScreen
Set objScreen = HMIRuntime.Screens("NewPDL1")
HMIRuntime.Trace "Min: " & objScreen.ObjectSizeDeclutteringMin & vbNewLine
HMIRuntime.Trace "Max: " & objScreen.ObjectSizeDeclutteringMax & vbNewLine
HMIRuntime.Trace "Enable: " & objScreen.LayerDeclutteringEnable & vbNewLine
See also
Screen Object (Page 140)
ObjectSizeDeclutteringMin Property
Description
Using the ObjectSizeDeclutteringMin property, the lower size range of a picture may be read.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
457
Objects which are smaller than the stated pixel size are no longer displayed when
ObjectSizeDecluttering is activated.
LONG read-only access.
Example:
The example outputs the Decluttering Properties of the picture NewPDL1 as a trace.
'VBS157
Dim objScreen
Set objScreen = HMIRuntime.Screens("NewPDL1")
HMIRuntime.Trace "Min: " & objScreen.ObjectSizeDeclutteringMin & vbNewLine
HMIRuntime.Trace "Max: " & objScreen.ObjectSizeDeclutteringMax & vbNewLine
HMIRuntime.Trace "Enable: " & objScreen.LayerDeclutteringEnable & vbNewLine
See also
Screen Object (Page 140)
OffsetLeft Property
Description
Defines or returns the distance of the picture from the left edge of the picture window.
The picture is displayed as a cutout of the picture window. The picture scroll bars are located
at
the left and upper edge of the picture. If you wish to display the picture in the picture window
by using the horizontal and vertical positioning of the picture scroll bars, use the properties
"ScrollPositionX" and "ScrollPositionY" for such positioning.
See also
ScrollPositionY Property (Page 502)
ScrollPositionX Property (Page 502)
Picture Window (Page 191)
ScreenItem Object (Page 134)
OffsetTop Property
Description
Defines or returns the distance of the picture from the top edge of the picture window.
The picture is displayed as a cutout of the picture window. The picture scroll bars are located
at
the left and upper edge of the picture. If you wish to display the picture in the picture window
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
458
System Manual, 11/2008,
by using the horizontal and vertical positioning of the picture scroll bars, use the properties
"ScrollPositionX" and "ScrollPositionY" for such positioning.
See also
ScrollPositionY Property (Page 502)
ScrollPositionX Property (Page 502)
Picture Window (Page 191)
ScreenItem Object (Page 134)
OneY Property
Description
TRUE if only the Y-axis of the trend is displayed in the foreground instead of all Y-axes of the
displayed trends. BOOLEAN write-read access.
Online Property
Description
Serves to start or stop updating.
● 0: The updated display is stopped. The values are buffered and updated when the button
is clicked again.
● -1: The updated display is resumed.
See also
ScreenItem Object (Page 134)
WinCC Online Table Control (before WinCC V7) (Page 269)
WinCC Online Trend Control (before WinCC V7) (Page 271)
WinCC Function Trend Control (before WinCC V7) (Page 267)
Online property
Refresh started - Online
Enables a refresh of displayed values when calling a picture in Runtime.
Value Description
TRUE Enables the refresh of values on picture calls.
FALSE Disables the refresh of values on picture calls.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
459
The attribute can be assigned dynamic properties by means of the name Online.
OnTop Property
Description
TRUE, when the object should remain in the foreground in Runtime. Read only access.
See also
Picture Window (Page 191)
Application Window (Page 186)
ScreenItem Object (Page 134)
Op
OperationMessage Property
Description
TRUE, if a message should be output upon successful operation. BOOLEAN Schreib-Lese-
Zugriff.
The operation is sent to the message system, and is archived. Using the message system, a
message may be output in a message line, for example.
Special features of I/O field, text list and slider
The reason for the operation may only be entered if the "OperationReport" property has been
set to TRUE.
See also
Slider (Page 223)
Text list (Page 210)
Radio box (Page 219)
Check box (Page 217)
I/O Field (Page 196)
ScreenItem Object (Page 134)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
460
System Manual, 11/2008,