SIMATIC HMI
WinCC V6
VBS Reference
Printout of the Online Help
Edition April 2003
A5E00243392
04.03
VBS Reference
Contents
1
VBS Reference ............................................................................................... 1
Objects and Lists................................................................................ . 2
1.1
ActiveScreen Object ........................................................................... . 3
1.1.1
1.1.2
ActiveScreenItem Object .................................................................... . 3
HMIRuntime Object ............................................................................ . 3
1.1.3
Item Object ......................................................................................... 4
1.1.4
Layer Object ...................................................................................... . 5
1.1.5
1.1.6
Layers Object (List) ........................................................... .................. 6
Parent Object ..................................................................................... . 6
1.1.7
ScreenItem Object.............................................................................. . 8
1.1.8
ScreenItems Object (List).................................................................. . 10
1.1.9
1.1.10
Screen Object .................................................................................. . 11
Screens Object (List) ......................................................................... 13
1.1.11
Tag Object ....................................................................................... . 14
1.1.12
Tags Object (List)............................................................................. . 16
1.1.13
Object Type of the ScreenItem Object ............................................... . 17
1.2
1.2.1
Standard objects .............................................................................. . 18
Ellipse ......................................... ..................................................... 18
1.2.1.1
Ellipse Arc ....................................................................................... . 18
1.2.1.2
Ellipse Segment ............................................................... ................. 19
1.2.1.3
1.2.1.4
Circle ............................................................................................... . 20
Circular Arc ...................................................................................... . 20
1.2.1.5
Pie Segment .................................................................................... . 21
1.2.1.6
Line ................................................................................................. . 22
1.2.1.7
1.2.1.8
Polygon ........................................................................................... . 22
Polyline ........................................................................................... . 23
1.2.1.9
Rectangle ......................................................................................... 24
1.2.1.10
Rounded Rectangle .......................................................................... . 25
1.2.1.11
Static Text ....................................................................................... . 27
1.2.1.12
1.2.1.13
Connector........................................................................................ . 28
Smart Objects .................................................................................. . 28
1.2.2
3D-Bar ............................................................................................. . 29
1.2.2.1
Application Window .......................................................................... . 30
1.2.2.2
1.2.2.3
Bar ........................................................... ........................................ 31
Picture Window ................................................................................ . 32
1.2.2.4
Control ........................................................................................ ..... 33
1.2.2.5
I/O Field ........................................................................................... . 35
1.2.2.6
1.2.2.7
Graphic Object ................................................................................. . 35
OLE Object ...................................................................................... . 36
1.2.2.8
Text List........................................................................................... . 38
1.2.2.9
Status Display ................................. .................................................. 39
1.2.2.10
Windows Objects ............................................................................. . 40
1.2.3
1.2.3.1
Button ................................................................................... ........... 40
Check Box ....................................................................................... . 41
1.2.3.2
Option Group ................................................................................... . 42
1.2.3.3
Round Button................................................................................... . 42
1.2.3.4
1.2.3.5
Slider ............................................................................................... . 43
Controls ........................................ .................................................... 45
1.2.4
WinCC Alarm Control ....................................................................... . 46
1.2.4.1
1.2.4.2
WinCC Digital Analog Clock ............................................................. .. 47
Printout of the Online Help
VBS Reference
i
VBS Reference
04.03
ii
1.2.4.3
1.2.4.4
1.2.4.5
1.2.4.6
1.2.4.7
1.2.4.8
1.2.4.9
1.2.4.10
1.2.5
1.2.6
1.3
1.3.1
1.3.1.1
1.3.1.2
1.3.1.3
1.3.1.4
1.3.1.5
1.3.1.6
1.3.1.7
1.3.1.8
1.3.1.9
1.3.1.10
1.3.1.11
1.3.1.12
1.3.1.13
1.3.1.14
1.3.1.15
1.3.1.16
1.3.1.17
1.3.1.18
1.3.1.19
1.3.1.20
1.3.1.21
1.3.1.22
1.3.1.23
1.3.1.24
1.3.1.25
1.3.1.26
1.3.1. 27
1.3.1.28
1.3.1.29
1.3.1.30
1.3.1.31
1.3.1.32
1.3.1.33
1.3.1.34
1.3.1.35
1.3.2
1.3.2.1
1.3.2.2
1.3.2.3
1.3.2.4
1.3.2.5
1.3.2.6
1.3.2.7
WinCC DXF Control ......................................................................... . 48
WinCC Function Trend Control ........................................................... 48
W inCC Gauge Control ...................................................................... . 48
W inCC Online Table Control .............................................................. 49
WinCC Online Trend Control .............................................................. 49
WinCC Push Button Control ............................................................... 51
WinCC Slider Control ........................................................................ 53
HMI Symbol Library 1.3 .................................................................... . 54
Customized object ............................................................................ . 55
Group object .................................................................................... . 55
Characteristics ................................................................................. . 55
A ...................................................................................................... 57
AccessPath Property ........................................................................ . 57
Activate Property ..................................................................... .......... 57
ActiveScreen Property ...................................................................... . 57
ActiveScreenItem Property ............................................................... . 57
Actualize Property ............................................................................ . 58
ActualPointLeft Property ................................................................... . 58
ActualPointTop Property .................................................................... 58
AdaptBorder Property ....................................................................... . 58
AdaptPicture Property....................................................................... . 59
AdaptSize Property .......................................................................... . 59
AlarmHigh Property .......................................................................... . 59
AlarmLow Property ........................................................................... . 59
Alignment Property ........................................................................... . 60
AlignmentLeft Property ..................................................................... . 60
AlignmentTop Property ..................................................................... . 60
AllowPersistence Property ................................................................ . 60
AllServer Property ............................................................................ . 60
Analog Property ............................................................................... . 61
AngleAlpha Property...................................................... .................... 61
AngleBeta Property .......................................................................... . 61
AngleMax Property ........................................................................... . 61
AngleMin Property ............................................................................ . 61
Application Property ......................................................................... . 61
Archive Property ................................ .............................................. . 62
Assignments Property....................................................................... . 62
AssumeOnExit Property.................................................................... . 62
AssumeOnFull Property .................................................................... . 62
Autorange Property .......................................................................... . 62
AutorangeX Property ........................................................................ . 63
AutorangeY Property ........................................................................ . 63
AutoScroll Property ........................................................ ................... 63
AutoSize Property ............................................................................ . 63
Average Property ............................................................................. . 63
Axe Property .................................................................................... . 64
AxisSection Property ........................................................................ . 64
B ...................................................................................................... 64
BackBorderWidth Property................................................................ . 64
BackColor Property ..................................................................... ...... 64
BackColor2 Property ........................................................................ . 65
BackColor3 Property ........................................................................ . 65
BackColorBottom Property................................................................ . 65
BackColorTop Property .................................................................... . 65
BackFlashColorOff Property...................................................... ......... 66
Printout of the Online Help
VBS Reference
04.03
VBS Reference
1.3.2.8
1.3.2.9
1.3.2.10
1.3.2.11
1.3.2.12
1.3.2.13
1.3.2.14
1.3.2.15
1.3.2.16
1.3.2.17
1.3.2.18
1.3.2.19
1.3.2.20
1.3.2.21
1.3.2.22
1.3.2.23
1.3.2.24
1.3.2.25
1.3.2. 26
1.3.2.27
1.3.2.28
1.3.2.29
1.3.2.30
1.3.2.31
1.3.2.32
1.3.2.33
1.3.2.34
1.3.2.35
1.3.2.36
1.3.2.37
1.3.2.38
1.3.2.39
1.3.2.40
1.3.2.41
1.3.2.42
1.3.2.43
1.3.2.44
1.3.2.45
1.3.2.46
1.3.2.47
1.3.2.48
1.3.2.49
1.3.2.50
1.3.2.51
1.3.2.52
1.3.2.53
1.3.2.54
1.3.2.55
1.3.2.56
1.3.3
1.3.3.1
1.3.3.2
1.3.3.3
1.3.3.4
1.3.3.5
BackFlashColorOn Property.............................................................. . 66
Background Property ..................................... .................................... 66
BackgroundPicture Property ............................................................. . 66
BackStyle Property ........................................................................... . 66
BarBackColor Property ..................................................................... . 67
BarDepth Property............................................................................ . 67
BarFillColor Property ......................................................................... 67
BarHeight Property ........................................................................... . 67
BarWidth Property ............................................................................. 67
BasePicReferenced Property ............................................................ . 67
BasePicTransColor Property .............................................................. 67
BasePicture Property........................................................................ . 67
BasePicUseTransColor Property ....................................................... . 67
BaseScreenName Property................................................................ 68
BaseY Property ................................................................................ . 69
BaseX Property ................................................................................ . 69
BeginTime Property .......................................................................... . 69
BeginValue Property......................................................................... . 69
BeginX Property ................................................................................ 69
BeginY Property ............................................................................... . 69
BevelColorDown Property ................................................................. . 70
BevelColorUp Property ..................................................................... . 70
BevelInner Property.......................................................................... . 70
BevelOuter Property ......................................................................... . 70
BevelWidth Property ......................................................................... . 71
BitNumber Property ........................................................... ................ 71
BlinkColor Property .......................................................................... . 71
BlinkMode Property .......................................................................... . 71
BlinkSpeed Property ......................................................................... . 71
BorderBackColor Property ................................................................ . 71
BorderColor Property...................................... ................................... 71
BorderColo rBottom Property .............................................................. 71
BorderColorTop Property .................................................................. . 72
BorderEndStyle Property .................................................................. . 72
BorderFlashColorOff Property ........................................................... . 72
BorderFlashColorOn Property ........................................................... . 72
BorderStyle Property ........................................................................ . 72
BorderWidth Property ....................................................................... . 73
BottomConnectedConnectionPointIndex Property ............................... 73
BottomConnectedObjectName Property ............................................ . 73
BoxAlignment Property ...................................................................... 73
BoxCount Property ........................................................................... . 73
BoxType Property ............................................................................ . 73
ButtonColor Property ........................................................................ . 74
ButtonCommand Property................................................................. . 74
Button1Width Property....................................................................... 75
Button2Width Property...................................................................... . 75
Button3Width Property...................................................................... . 75
Button4Width Property...................................................................... . 75
C..................................................................................................... . 75
Caption Property .............................................................................. . 75
CaptionColor Property ...................................................................... . 76
CaptionFont Property ........................................................................ 76
CaptionOffset Property ..................................................................... . 76
CaptionText Property........................................................................ . 76
Printout of the Online Help
VBS Reference
iii
VBS Reference
04.03
i v
1.3.3.6
1.3.3.7
1.3.3.8
1.3.3.9
1.3.3.10
1.3.3.11
1.3.3.12
1.3.3.13
1.3.3.14
1.3.3.15
1.3.3.16
1.3.3.17
1.3.3.18
1.3.3.19
1.3.3.20
1.3.3.21
1.3.3.22
1.3.3.23
1.3.3.24
1.3.3.25
1.3.3.26
1.3.3.27
1.3.3.28
1.3.3.29
1.3.3.30
1.3.3.31
1.3.3.32
1.3.3.33
1.3.3.34
1.3.3.35
1.3.3.36
1.3.3.37
1.3.3.38
1.3.3.39
1.3.3.40
1.3.3.41
1.3.3.42
1.3.3.43
1.3.3.44
1.3.3.45
1.3.3.46
1.3.3.47
1.3.3.48
1.3.3.49
1.3.3.50
1.3.3.51
1.3.3.52
1.3.3.53
1.3.3.54
1.3.3.55
1.3.4
1.3.4.1
1.3.4.2
1.3.4.3
1.3.4.4
CellCut Property ............................................................................... . 76
CenterColor Property................................................................ ......... 76
CenterScale Property ....................................................................... . 77
CheckAlarmHigh Property................................................................. . 77
CheckAlarmLow Property ................................................................. . 77
CheckLimitHigh4 Property ................................................................ . 77
CheckLimitHigh5 Property ................................................................. 77
CheckLimitLow4 Property ................................................................. . 78
CheckLimitLow5 Property ................................................................. . 78
CheckToleranceHigh Property .......................................................... . 78
CheckToleranc eLow Property ............................................................ 78
CheckWarningHigh Property .............................................................. 78
CheckWarningLow Property.............................................................. . 79
ClearOnError Property ...................................................................... . 79
ClearOnNew Property........................................................................ 79
Closeable Property ........................................................................... . 79
CloseButton Property ........................................................................ 79
CoarseGrid Property......................................................................... . 79
Coars eGridX Property ...................................................................... . 79
CoarseGridY Property ...................................................................... . 80
CoarseGridValue Property ................................................................ . 80
CoarseGridValueX Property .............................................................. . 80
CoarseGridValueY Prop erty ............................................................... 80
CollectValue Prope rty ....................................................................... . 80
ColMove Property ............................................................................ . 80
Color Property.................................................................................. . 80
ColorAlarmHigh Property ................................................................... 81
ColorAlarmLow Property ................................................................... . 81
ColorBottom Property ....................................................................... . 81
ColorChangeType Property............................................................... . 81
ColorLimitHigh4 Property .................................................................. . 81
ColorLimitHigh5 Property .................................................................. . 81
ColorLimitLow4 Property................................................................... . 82
ColorLimitLow5 Property.................................................................... 82
ColorToleranceHigh Property ............................................................. 82
ColorToleranceLow Property .............................................................. 82
ColorTop Property ............................................................................ . 82
ColorWarningHigh Property ............................................................... 82
ColorWarningLow Property ................................................................ 83
ColTitle Property .............................................................................. . 83
Command Property .......................................................................... . 83
ColWidth Property ............................................................................ . 83
CommonTime Property ..................................................................... . 83
CommonX Property ............................................ .............................. . 83
CommonY Property .......................................................................... . 83
ContinousChange Property ............................................................... . 84
CurrentContext Property ................................................................... . 84
Cursor Property................................................................................ . 84
CursorControl Property ...................................................................... 84
CurveForm Property ......................................................................... . 85
D............................................................................................. ......... 85
DangerColor Property ....................................................................... . 85
Danger Property ............................................................................... . 85
DataFormat Property ........................................................................ . 85
DataIndex Prop erty .......................................................................... . 86
Printout of the Online Help
VBS Reference
04.03
VBS Reference
1.3.4.5
1.3.4.6
1.3.4.7
1.3.4.8
1.3.4.9
1.3.4.10
1.3.4.11
1.3.4.12
1.3.4.13
1.3.4.14
1.3.4.15
1.3.4.16
1.3.4.17
1.3.4.18
1.3.4.19
1.3.5
1.3.5.1
1.3.5.2
1.3.5.3
1.3.5.4
1.3.5.5
1.3.5.6
1.3.5.7
1.3.5.8
1.3.5.9
1.3.5.10
1.3.5.11
1.3.5.12
1.3.6
1.3.6.1
1.3.6.2
1.3.6.3
1.3.6.4
1.3.6.5
1.3.6.6
1.3.6.7
1.3.6.8
1.3.6.9
1.3.6.10
1.3.6.11
1.3.6.12
1.3.6.13
1.3.6.14
1.3.6.15
1.3.6.16
1.3.6.17
1.3.6.18
1.3.6.19
1.3.6.20
1.3.6.21
1.3.6.22
1.3.6.23
1.3.6.24
1.3.6.25
1.3.6.26
DataX Property ................................................................................ . 86
DataXY Property .............................................................................. . 86
DataY Property ................................................................................ . 86
DeleteData Property ......................................................................... . 86
Delta Property ......................................................... .......................... 86
Desired CurveColor Property .............................................................. 86
DesiredCurveCurveForm Property..................................................... . 87
DesiredCurveSourceNumberOfUAValues Property ............................. 87
DesiredCurveSourceUAArchive Property ........................................... . 87
DesiredCurveSourceUAArchiveStartID Property................................. . 87
DesiredCurveSourceUAColumnX Property ......................................... 87
DesiredCurveSourceUAColumnY Property ......................................... 88
DesiredCurveVisible Property ................................................ ............ 88
Direction Property ............................................................................ . 88
DXFFilename Property ..................................................................... . 88
E ..................................................................................................... . 89
Edit Property .................................................................................... . 89
Editable Property............................................................................... 89
EditAtOnce Property ......................................................................... . 89
Enabled Property ........................................................................... ... 89
EndAngle Property ........................................................................... . 90
EndTime Property ............................................................................ . 90
EndValue Property ........................................................................... . 90
EndX Property ................................................................................. . 90
EndY Property .................................................................................. 90
Error Property .................................................................................. . 90
Exponent Property............................................................................ . 91
ExtendedOperation Property .............................................................. 91
F ..................................................................................................... . 91
FillColor Property ............................................................................. . 91
Filling Property ................................................................................. . 92
FillingIndex Property .......................................................................... 92
FillStyle Property .............................................................................. . 92
FillStyle2 Property ............................................................................ . 93
FineGrid Property ............................................................................. . 93
FineGridValue Property .................................................................... . 93
FineGridValueX Property .......................... ........................................ . 93
FineGridValueY Property .................................................................. . 94
FineGridX Property........................................................................... . 94
FineGridY Property........................................................................... . 94
FlashBackColor Property .................................................................. . 94
FlashBorderColor Property ............................................................... . 94
FlashFlashPicture Property ............................................................... . 94
FlashForeColor Property............................................................... ..... 94
FlashPicReferenced Property............................................................. 94
FlashPicTransColor Property ............................................................ . 95
FlashPicture Property ........................................................................ 95
FlashPicUseTransColor Property ....................................................... 95
FlashRate Property .................................................................. ......... 95
FlashRateBackColor Property ........................................................... . 95
FlashRateBorderColor Property ......................................................... 96
FlashRateFlashPic Property............................................................... 96
FlashRateForeColor Property............................................................. 96
Flip Property ........................................................................ ............. 96
FocusColor Property......................................................................... . 96
Printout of the Online Help
VBS Reference
v
VBS Reference
04.03
vi
1.3.6.27
1.3.6.28
1.3.6.29
1.3.6.30
1.3.6.31
1.3.6.32
1.3.6.33
1.3. 6.34
1.3.6.35
1.3.6.36
1.3.6.37
1.3.6.38
1.3.6.39
1.3.6.40
1.3.6.41
1.3.6.42
1.3.6.43
1.3.6.44
1.3.6.45
1.3.6.46
1.3.7
1.3.7.1
1.3.7.2
1.3.7.3
1.3.7.4
1.3.7.5
1.3.7.6
1.3.7.7
1.3.7.8
1.3.7.9
1.3.8
1.3.8.1
1.3.8.2
1.3.8.3
1.3.8.4
1.3.8.5
1.3.8.6
1.3.8.7
1.3.8.8
1.3.8.9
1.3.9
1.3.9.1
1.3.9.2
1.3.9.3
1.3.9.4
1.3.9.5
1.3.9.6
1.3.9.7
1.3.9.8
1.3.9.9
1.3.10
1.3.10.1
1.3.10.2
1.3.10.3
1.3.10.4
FocusRect Property ............................ .............................................. . 97
FocusWidth Property ........................................................................ . 97
Font Property ............................................................................ ........ 97
FontBold Property ............................................................................ . 97
FontItalic Property ............................................................................ . 98
FontName Property .......................................................................... . 98
FontPosition Property ....................................................................... . 98
FontSize Property ............................................................................ . 98
FontStrikeThru Property.................................................................... . 98
FontUnderline Property..................................................................... . 98
ForeColor Property ........................................................................... . 98
ForeFlashColorOff Property .............................................................. . 99
ForeFlashColorOn Property .............................................................. . 99
FrameColor Property ........................................................................ . 99
FrameColorDown Property ............................................................... . 99
FrameColorUp Property .................................................................... . 99
FramePicture Property...................................................................... . 99
FrameScale Property........................................................................ . 99
FrameWidth Property ..................................................................... . 100
FreezeProviderConnec tions Property ............................................... 100
G................................................................................................... . 100
OraphDirection Property ................................................................. . 100
GridLineHorz Property .................................................................... . 100
GridLines Property ......................................................................... . 100
GridLineValue Property ................................................................... 101
GridlinesValueX Property ................................................................ . 101
GridlinesValueY Property ................................................................ . 101
GridLineVert Property ..................................................................... . 101
GridlinesX Property ........................................................................ . 101
GridlinesY Property ......................................................................... 101
H................................................................................................... . 101
andFillColor Property ...................................................................... . 101
Handtype Property ......................................................................... . 101
Height Property .............................................................................. . 101
HiddenInput Property...................................................................... . 102
Hotkey Property ............................................................................. . 103
HourNeedleHeight Property ............................................................. 103
HourNeedleWidth Prop erty ............................................................. . 103
Hysteresis Property ........................................................................ . 103
HysteresisRange Property .............................................................. . 103
Index Property ............................................................................... . 104
InnerBevelOffset Property ........................................................... ..... 104
InnerBevelStyle Property ................................................................ . 104
InnerBevelWidth Property ............................................................... . 104
InsertData Property ......................................................................... 105
ItemBorderBackColor Property ......................................................... 105
ItemBorderColor Property ........................................................... ..... 105
ItemBorderStyle Property ................................................................ . 105
ItemBorderWidth Property............................................................... . 105
ItemVisible Property ........................................................................ 105
L ................................................................................................... . 106
abel Property ................................................................................. . 106
LabelColor Property ....................................................................... . 106
LabelX Property ............................................................................. . 106
LabelY Property ............................................................................. . 106
Printout of the Online Help
VBS Reference
04.03
VBS Reference
1.3.10.5
1.3.10.6
1.3.10.7
1.3.10.8
1.3.10.9
1.3.10.10
1.3.10.11
1.3.10.12
1.3.10.13
1.3.10.14
1.3.10.15
1.3.10.16
1.3.10.17
1.3.10.18
1.3.10.19
1.3.10.20
1.3.10.21
1.3.10.22
1.3.10.23
1.3.10.24
1.3.10.25
1.3.10.26
1.3.10.27
1.3.10.28
1.3.10.29
1.3.10.30
1.3.10.31
1.3.10.32
1.3.10.33
1.3.10.34
1.3.10.35
1.3.10.36
1.3.10.37
1.3.10.38
1.3.10.39
1.3.10.40
1.3.10.41
1.3.10.42
1.3.10.43
1.3.10.44
1.3.10.45
1.3.10.46
1.3.10.47
1.3.10.48
1.3.10.49
1.3.10.50
1.3.10.51
1.3.10.52
1.3.10.53
1.3.10.54
1.3.10.55
1.3.10.56
1.3.10.57
1.3.10.58
1.3.10.59
LanguageSwitch Property ................................................................ 106
Language Property ......................................................................... . 106
LastError Property .......................................................................... . 106
Layer Property ............................................................................... . 107
Layer00Checked Property .............................................................. . 108
Layer01Checked Property .............................................................. . 108
Layer02Checked Property .............................................................. . 108
Layer03Checked Property .............................................................. . 108
Layer04Checked Property .............................................................. . 109
Layer05Checked Property .............................................................. . 109
Layer06Checked Property .............................................................. . 109
Layer07Checked Property .............................................................. . 109
Layer08Checked Property .............................................................. . 109
Layer09Checked Property .............................................................. . 110
Layer10Checked Property .............................................................. . 110
Layer00Color Property....................................... ............................. . 110
Layer01Color Property.................................................................... . 110
Layer02Color Property.................................................................... . 110
Layer03Color Property.................................................................... . 110
Layer04Color Property.................................................................... . 111
Layer05Color Property.......................... .......................................... . 111
Layer06Color Property.................................................................... . 111
Layer07Color Property.................................................................... . 111
Layer08Color Property.................................................................... . 111
Layer09Color Property.................................................................... . 111
Layer10Color Property.................................................................... . 112
Layer00Value Property ................................................................... . 112
Layer01Value Property .................................................................... 112
Layer02Value Property ................................................................... . 112
Layer03Value Property ................................................................... . 112
Layer04Value Property ................................................................... . 112
Layer05Value Property ................................................................... . 113
Layer06Value Property ............................................. ....................... 113
Layer07Value Property ................................................................... . 113
Layer08Value Property ................................................................... . 113
Layer09Value Property ................................................................... . 113
Layer10Value Property ................................................................... . 113
Left Propert y ................................................................................... 114
LeftComma Property ...................................................................... . 114
LightEffect Property ....................................................................... .. 114
LimitHigh4 Property ........................................................................ . 114
LimitHigh5 Property ........................................................................ . 115
LimitLow4 Property......................................................................... . 115
LimitLow5 Property......................................................................... . 115
LimitMax Property .......................................................................... . 115
LimitMin Property ........................................................................... . 115
LineFont Property........................................................................... . 115
LineHeight Property........................................................................ . 115
LineTitle Property ........................................................................... . 115
ListType Property ........................................................................... . 116
LoadDataImmediately Property ....................................................... . 116
LocaleID Property ........................................................................... 116
LockBackColor Property ................................................................. . 116
LockStatus Property ....................................................................... . 117
LockText Property .......................................................................... . 117
Printout of the Online Help
VBS Reference
vii