System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
InnerBevelOffset Property
Description
Defines the distance between the inner and outer bevels.
See also
WinCC Slider Control (Page 259)
ScreenItem Object (Page 134)
InnerBevelStyle Property
Description
Defines the 3D effect for the inner bevel of the object.
● 0: No border.
● 1: The border is displayed depressed.
● 2: The border is displayed raised.
● 3: The border is displayed in one color without a 3D effect. The border color is defined by
the "BevelColorDown" property.
See also
WinCC Slider Control (Page 259)
ScreenItem Object (Page 134)
InnerBevelWidth Property
Description
Defines the width of the inner bevel in pixels.
See also
WinCC Slider Control (Page 259)
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,
401
InputValue property
Description
Defines or returns the value specified by the user in the IO field.
You can configure the IO field with this attribute so that the input value changed by the user
is also displayed in the IO field after confirming with the <Return> key.
This requires that you configure a direct connection between the "Input value" and "Output
value"
attributes. Without this direct connection, the entered value is deleted after acceptance
with the <Return> key. The direct connection is only practical when no tag is connected to the
output value, but the user can nevertheless query the specified value, for example, through a
script.
LONG write-read access.
InsertData Property
Description
Inserts data for the current trend.
TRUE : "DataIndex" is ignored and the data is appended to that in the data buffer.
FALSE : The data is inserted at the "DataIndex" position in the data buffer.
The trend window is redrawn following each operation involving "Insert Data".
See also
WinCC Function Trend Control (before WinCC V7) (Page 267)
ScreenItem Object (Page 134)
Instance property
Description
Returns an instance of the alarm object.
See also
Alarms object (list) (Page 116)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
402
System Manual, 11/2008,
ItemBorderBackColor Property
Description
Defines or returns the background color for dividing lines in the selection list of the text list
object.
LONG write-read access. The background color is only visible with the property setting
ItemBorderStyle > 0.
See also
Text list (Page 210)
ScreenItem Object (Page 134)
ItemBorderColor Property
Description
Defines or returns the color for deviding lines in the selection list of the text list object. LONG
write-read access.
See also
Text list (Page 210)
ScreenItem Object (Page 134)
ItemBorderStyle Property
Description
Defines or returns the color for the dividing line style in the selection list of the text list object.
Value range from 0 to 4.
0 = solid line
1 = dashed line
2 = dotted line
3 = dash-dotted line
4 = dash-dot-dot line
See also
Text list (Page 210)
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,
403
ItemBorderWidth Property
Description
Defines or returns the dividing line weight in pixels in the selection list of the text list object.
See also
Text list (Page 210)
ScreenItem Object (Page 134)
ItemProviderClsid Property
Description
"ItemProviderCIsid" shows, if the trend referenced using Index in Trend Control is connected
with an archive tag or an online tag.
Notice: If you assign a value to the "ProviderCIsid" property , you will overwrite the trend-
specific property "ItemProviderCIsid".
● {416A09D2-8B5A-11D2-8B81-006097A45D48}: The trend is connected to an archive tag.
● {A3F69593-8AB0-11D2-A440-00A0C9DBB64E}: The trend is connected to an online tag.
If the trends are being supplied with archive and online tags, the property "ProviderCIsid"
returns the value "{00000000-0000-0000-0000-000000000000}".
ItemVisible Property
Description
TRUE, when a trend or a column pair reference by the "Index" property is visible. BOOLEAN
write-read access.
See also
WinCC Online Trend Control (before WinCC V7) (Page 271)
WinCC Online Table Control (before WinCC V7) (Page 269)
WinCC Function Trend Control (before WinCC V7) (Page 267)
ScreenItem Object (Page 134)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
404
System Manual, 11/2008,
1.14.4.11 L
Lab - Las
Label Property
Description
The "Index" property references a trend. Label is used to define the name of the time axis or
value axis in accordance with the value of the "TimeAxis" property.
See also
WinCC Online Trend Control (before WinCC V7) (Page 271)
ScreenItem Object (Page 134)
LabelColor Property
Description
Defines the color of the scale label.
See also
WinCC Slider Control (Page 259)
ScreenItem Object (Page 134)
LabelX Property
Description
Defines or returns the label on the X-axis for a trend referenced by "Index" according to the
value of "TimeAxisX". Write/Read access.
See also
WinCC Function Trend Control (before WinCC V7) (Page 267)
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,
405
LabelY Property
Description
Defines or returns the label on the Y-axis for a trend referenced by "Index" according to the
value of "TimeAxisY". Write/Read access.
See also
WinCC Function Trend Control (before WinCC V7) (Page 267)
ScreenItem Object (Page 134)
LanguageSwitch Property
Description
Returns the value which defines where the language dependent assigned texts are stored.
Read only access.
TRUE, when the texts in the Text Library are managed. Translation to other language occurs
in the Text Library.
FALSE, when the texts are managed directly in the object. Translation to other language can
be carried out using Text Distributor.
See also
Text list (Page 210)
ScreenItem Object (Page 134)
Language Property
Description
Defines the current Runtime language or reads it.
You specify the Runtime language in VBS by using a country code, e.g., 1031 for German -
Default, 1033 for English - USA etc. A summary of all country codes may be found in the Basics
of VBScript under the subject header "Regional Scheme ID (LCID) Diagram".
INTEGER (write-read access)
Example:
The following example sets the data language to German:
'VBS76
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
406
System Manual, 11/2008,
HMIRuntime.Language = 1031
See also
HMIRuntime Object (Page 125)
LastError Property
Description
Returns an error code regarding the success of the last operation, e.g. information on a tag
write or read process. The "QualityCode" property can provide information on the quality of
the returned value. A description of the error can be called in using the "ErrorDescription"
property.
LONG (read only)
The following error codes are defined:
Code in hexadecimal notation Description
0x00000000 OK
0x80040001 Execution error
0x80040002 Tag error
0x80040003 Server not available.
0x80040004 Multi Tag Error (Error in one or several tags)
In order that LastError returns a value, a read must be executed beforehand.
If an error occurs during read or write of several tags using the TagSet object, the error is set
to "Multi Tag Error". In order to determine at which tag the error occurred and what type of
error it was, the LastError property of each tag must be analyzed.
Example:
The following example displays the error code for "Tag1":
'VBS77
Dim objTag
Set objTag = HMIRuntime.Tags("Tag1")
objTag.Read
MsgBox objTag.LastError
The following example adds two tags to the TagSet list and outputs the LastError property as
Trace.
'VBS178
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
407
Dim group
Set group = HMIRuntime.Tags.CreateTagSet
group.Add "Motor1"
group.Add "Motor2"
HMIRuntime.Trace "LastError: " & group.LastError & vbNewLine
The LastError property of a tag contained in the list may be accessed as follows:
HMIRuntime.Trace "LastError: " & group("Motor1").LastError & vbNewLine
See also
TagSet Object (List) (Page 151)
QualityCode Property (Page 487)
ErrorDescription Property (Page 363)
Tag Object (Page 146)
Layer
Layer Property
Description
Returns the layer of the picture in which the object is located. There is a total of 32 layers
available, whereby Layer "0" is the bottom layer and Layer "31" the top layer.
The configured objects are initially in the background of a layer.
LONG (read only)
Note
The layer property specifies the layer in which the object is located. The layer "0" is output
as "Layer0".
When accessed, the layers are counted up from 1 in VBS. Therefore, the layer "1" must be
addressed with "layers(2)".
Example:
The following example displays the name and layer of all the objects in the picture "NewPDL1":
'VBS78
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
408
System Manual, 11/2008,
Dim objScreen
Dim objScrItem
Dim lngAnswer
Dim lngIndex
Dim strName
lngIndex = 1
Set objScreen = HMIRuntime.Screens("NewPDL1")
For lngIndex = 1 To objScreen.ScreenItems.Count
strName = objScreen.ScreenItems.Item(lngIndex).ObjectName
Set objScrItem = objScreen.ScreenItems(strName)
lngAnswer = MsgBox(strName & " is in layer " & objScrItem.Layer,vbOKCancel)
If vbCancel = lngAnswer Then Exit For
Next
See also
ScreenItem Object (Page 134)
Layer00Checked Property
Description
TRUE, when limit 0 should be monitored. BOOLEAN write/read access.
Limit value and representation are defined with the Layer00Value and Layer00Color
properties.
See also
3D Bar (Page 182)
ScreenItem Object (Page 134)
Layer01Checked Property
Description
TRUE, when limit 1 should be monitored. BOOLEAN write/read access.
Limit value and representation are defined with the Layer01Value and Layer01Color
properties.
See also
3D Bar (Page 182)
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,
409
Layer02Checked Property
Description
TRUE, when limit 2 should be monitored. BOOLEAN write/read access.
Limit value and representation are defined with the Layer02Value and Layer02Color
properties.
See also
3D Bar (Page 182)
ScreenItem Object (Page 134)
Layer03Checked Property
Description
TRUE, when limit 3 should be monitored. BOOLEAN write/read access.
Limit value and representation are defined with the Layer03Value and Layer03Color
properties.
See also
3D Bar (Page 182)
ScreenItem Object (Page 134)
Layer04Checked Property
Description
TRUE, when limit 4 should be monitored. BOOLEAN write/read access.
Limit value and representation are defined with the Layer04Value and Layer04Color
properties.
See also
3D Bar (Page 182)
ScreenItem Object (Page 134)
Layer05Checked Property
Description
TRUE, when limit 5 should be monitored. BOOLEAN write/read access.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
410
System Manual, 11/2008,