SYS600 - Visual SCIL Objects

MicroSCADA X SYS600 10.
3
Visual SCIL Objects
Document ID: 1MRK 511 548-UEN
Issued: November 2021
Revision: A
Product version: 10.3
© 2021 Hitachi Energy. All rights reserved.

1MRK 511 548-UEN Rev. A Table of contents
Table of contents
Section 1 Copyrights....................................................................................................13
Section 2 Introduction..................................................................................................15
2.1 Use of symbols....................................................................................................................15
2.2 Intended audience...............................................................................................................15
2.3 Related documents............................................................................................................. 15
2.4 Document conventions........................................................................................................15
2.5 Document revisions.............................................................................................................16
Section 3 General properties.......................................................................................17

3.1 Overview............................................................................................................................. 17
3.1.1 Predefined attributes......................................................................................................... 17
3.1.2 Predefined methods.......................................................................................................... 17
3.2 Details................................................................................................................................. 17
3.2.1 Predefined attributes......................................................................................................... 17
3.2.2 Predefined methods.......................................................................................................... 21
Section 4 VS_BOX........................................................................................................ 25
4.1 Overview............................................................................................................................. 25
4.1.1 Action Attributes................................................................................................................ 25
4.1.2 Action Methods..................................................................................................................25
4.1.3 Predefined Attributes.........................................................................................................25
4.1.4 Predefined Methods.......................................................................................................... 26
4.2 Details................................................................................................................................. 26
4.2.2 Action Methods..................................................................................................................27
Section 5 VS_BUTTON................................................................................................. 33
5.1 Overview............................................................................................................................. 33
5.1.2 Action Methods..................................................................................................................33
5.2 Details................................................................................................................................. 34
5.2.2 Action Methods..................................................................................................................35
Section 6 VS_CHECK_BOX......................................................................................... 43
6.1 Overview............................................................................................................................. 43
MicroSCADA X SYS600 10.3 1

Visual SCIL Objects
Table of contents 1MRK 511 548-UEN Rev. A

6.1.2 Action Methods..................................................................................................................43
6.2 Details................................................................................................................................. 44
6.2.2 Action Methods..................................................................................................................45
Section 7 VS_COMBO.................................................................................................. 51
7.1 Overview............................................................................................................................. 51
7.1.2 Action Methods..................................................................................................................51
7.2 Details................................................................................................................................. 52
7.2.2 Action Methods..................................................................................................................53
Section 8 VS_COMBO_POPDOWN............................................................................. 63
8.1 Overview............................................................................................................................. 63
8.1.2 Action Methods..................................................................................................................63
8.2 Details................................................................................................................................. 64
8.2.2 Action Methods..................................................................................................................65
Section 9 VS_CONTAINER...........................................................................................75
9.1 Overview............................................................................................................................. 75
9.1.2 Action Methods..................................................................................................................75
9.2 Details................................................................................................................................. 76
9.2.2 Action Methods..................................................................................................................77
Section 10 VS_DIALOG.................................................................................................. 87
2 MicroSCADA X SYS600 10.3

Visual SCIL Objects
10.1 Overview............................................................................................................................. 87
10.1.2 Action Methods..................................................................................................................87
10.2 Details................................................................................................................................. 89
10.2.2 Action Methods..................................................................................................................89
Section 11 VS_FILE_CHOOSER.................................................................................. 103

11.1 Overview........................................................................................................................... 103
11.1.1 Action Attributes.............................................................................................................. 103
11.1.2 Action Methods................................................................................................................103
11.1.3 Predefined Attributes.......................................................................................................103
11.1.4 Predefined Methods........................................................................................................ 104
11.2 Details............................................................................................................................... 104
11.2.2 Action Methods................................................................................................................105
Section 12 VS_GRAPH................................................................................................. 119

12.1 Overview............................................................................................................................119
12.1.2 Action Methods................................................................................................................119
12.1.3 Predefined Attributes....................................................................................................... 119
12.2 Details............................................................................................................................... 120
12.2.2 Action Methods................................................................................................................121
Section 13 VS_GRAPH_LEGEND................................................................................ 133

13.1 Overview........................................................................................................................... 133
13.1.2 Action Methods................................................................................................................133
13.2 Details............................................................................................................................... 134
13.2.2 Action Methods................................................................................................................134

Visual SCIL Objects
Section 14 VS_HEADER...............................................................................................139
14.1 Overview........................................................................................................................... 139
14.1.2 Action Methods................................................................................................................139
14.2 Details............................................................................................................................... 140
14.2.2 Action Methods................................................................................................................141
Section 15 VS_HEADER_ITEM.................................................................................... 149

15.1 Overview........................................................................................................................... 149
15.2 Details............................................................................................................................... 149
Section 16 VS_ICON_VIEW..........................................................................................153
16.1 Overview........................................................................................................................... 153
16.1.2 Action Methods................................................................................................................153
16.2 Details............................................................................................................................... 155
16.2.2 Action Methods................................................................................................................155
Section 17 VS_IMAGE.................................................................................................. 167

17.1 Overview........................................................................................................................... 167
17.2 Details............................................................................................................................... 167
Section 18 VS_IMAGE_DOMAIN..................................................................................173
18.1 Overview........................................................................................................................... 173
18.1.2 Action Methods................................................................................................................173
18.2 Details............................................................................................................................... 175
18.2.2 Action Methods................................................................................................................175

Visual SCIL Objects

Section 19 VS_IMAGE_EDITOR...................................................................................189
19.1 Overview........................................................................................................................... 189
19.1.2 Action Methods................................................................................................................189
19.2 Details............................................................................................................................... 190
19.2.2 Action Methods................................................................................................................191
Section 20 VS_INPUT_DIALOG................................................................................... 203

20.1 Overview........................................................................................................................... 203
20.1.2 Action Methods................................................................................................................203
20.2 Details............................................................................................................................... 205
20.2.2 Action Methods................................................................................................................205
Section 21 VS_LABEL.................................................................................................. 219

21.1 Overview........................................................................................................................... 219
21.1.2 Action Methods................................................................................................................219
21.2 Details............................................................................................................................... 220
21.2.2 Action Methods................................................................................................................220
Section 22 VS_LINE......................................................................................................223
22.1 Overview........................................................................................................................... 223
22.1.2 Action Methods................................................................................................................223
22.2 Details............................................................................................................................... 224

Visual SCIL Objects
22.2.2 Action Methods................................................................................................................224

Section 23 VS_LIST...................................................................................................... 227

23.1 Overview........................................................................................................................... 227
23.1.2 Action Methods................................................................................................................227
23.2 Details............................................................................................................................... 229
23.2.2 Action Methods................................................................................................................230
Section 24 VS_MAIN_DIALOG.....................................................................................243
24.1 Overview........................................................................................................................... 243
24.1.2 Action Methods................................................................................................................243
24.2 Details............................................................................................................................... 245
24.2.2 Action Methods................................................................................................................245
Section 25 VS_MENU................................................................................................... 261

25.1 Overview........................................................................................................................... 261
25.1.2 Action Methods................................................................................................................261
25.2 Details............................................................................................................................... 262
25.2.2 Action Methods................................................................................................................262
Section 26 VS_MENU_ITEM.........................................................................................267
26.1 Overview........................................................................................................................... 267
26.1.2 Action Methods................................................................................................................267
26.2 Details............................................................................................................................... 268

Visual SCIL Objects

26.2.2 Action Methods................................................................................................................268
Section 27 VS_MENUBAR............................................................................................271
27.1 Overview........................................................................................................................... 271
27.1.2 Action Methods................................................................................................................271
27.2 Details............................................................................................................................... 272
27.2.2 Action Methods................................................................................................................272
Section 28 VS_NOTEBOOK......................................................................................... 277

28.1 Overview........................................................................................................................... 277
28.1.2 Action Methods................................................................................................................277
28.2 Details............................................................................................................................... 278
28.2.2 Action Methods................................................................................................................278
Section 29 VS_NOTEBOOK_PAGE............................................................................. 283

29.1 Overview........................................................................................................................... 283
29.1.2 Action Methods................................................................................................................283
29.2 Details............................................................................................................................... 284
29.2.2 Action Methods................................................................................................................284
Section 30 VS_NOTICE_DIALOG................................................................................ 291

30.1 Overview........................................................................................................................... 291
30.1.2 Action Methods................................................................................................................291

Visual SCIL Objects
30.2 Details............................................................................................................................... 293

30.2.2 Action Methods................................................................................................................294
Section 31 VS_NUMERIC_SPINNER........................................................................... 311

31.1 Overview............................................................................................................................311
31.1.2 Action Methods................................................................................................................311
31.1.3 Predefined Attributes....................................................................................................... 311
31.2 Details............................................................................................................................... 312
31.2.2 Action Methods................................................................................................................313
Section 32 VS_OPTION_BUTTON............................................................................... 319

32.1 Overview........................................................................................................................... 319
32.1.2 Action Methods................................................................................................................319
32.2 Details............................................................................................................................... 320
32.2.2 Action Methods................................................................................................................321
Section 33 VS_PALETTE..............................................................................................327
33.1 Overview........................................................................................................................... 327
33.1.2 Action Methods................................................................................................................327
33.2 Details............................................................................................................................... 328
33.2.2 Action Methods................................................................................................................329
Section 34 VS_PICTURE_CONTAINER....................................................................... 339

34.1 Overview........................................................................................................................... 339
34.1.2 Action Methods................................................................................................................339

Visual SCIL Objects

34.2 Details............................................................................................................................... 340
34.2.2 Action Methods................................................................................................................341
Section 35 VS_PRINT_OBJECT...................................................................................349
35.1 Overview........................................................................................................................... 349
35.1.2 Action Methods................................................................................................................349
35.2 Details............................................................................................................................... 350
35.2.2 Action Methods................................................................................................................350
Section 36 VS_PROGRAM_EDITOR............................................................................359
36.1 Overview........................................................................................................................... 359
36.1.2 Action Methods................................................................................................................359
36.2 Details............................................................................................................................... 361
36.2.2 Action Methods................................................................................................................362
Section 37 VS_SCROLL_BAR..................................................................................... 375

37.1 Overview........................................................................................................................... 375
37.1.2 Action Methods................................................................................................................375
37.2 Details............................................................................................................................... 376
37.2.2 Action Methods................................................................................................................376
Section 38 VS_SEPARATOR_MENU_ITEM.................................................................383
38.1 Overview........................................................................................................................... 383

Visual SCIL Objects
38.2 Details............................................................................................................................... 383

Section 39 VS_SLIDER.................................................................................................385
39.1 Overview........................................................................................................................... 385
39.1.2 Action Methods................................................................................................................385
39.2 Details............................................................................................................................... 386
39.2.2 Action Methods................................................................................................................386
Section 40 VS_SPLIT_BAR.......................................................................................... 393

40.1 Overview........................................................................................................................... 393
40.1.2 Action Methods................................................................................................................393
40.2 Details............................................................................................................................... 394
40.2.2 Action Methods................................................................................................................394
Section 41 VS_SUB_MENU_ITEM............................................................................... 397

41.1 Overview........................................................................................................................... 397
41.2 Details............................................................................................................................... 397
Section 42 VS_TABLE.................................................................................................. 401

42.1 Overview........................................................................................................................... 401
42.1.2 Action Methods................................................................................................................401
42.2 Details............................................................................................................................... 406
42.2.2 Action Methods................................................................................................................407

Visual SCIL Objects
Section 43 VS_TEXT.....................................................................................................453
43.1 Overview........................................................................................................................... 453
43.1.2 Action Methods................................................................................................................453
43.2 Details............................................................................................................................... 455
43.2.2 Action Methods................................................................................................................456
Section 44 VS_TEXT_EDITOR..................................................................................... 469

44.1 Overview........................................................................................................................... 469
44.1.2 Action Methods................................................................................................................469
44.2 Details............................................................................................................................... 471
44.2.2 Action Methods................................................................................................................472
Section 45 VS_TEXT_SPINNER...................................................................................485
45.1 Overview........................................................................................................................... 485
45.1.2 Action Methods................................................................................................................485
45.2 Details............................................................................................................................... 486
45.2.2 Action Methods................................................................................................................487
Section 46 VS_TOGGLE_MENU_ITEM........................................................................495
46.1 Overview........................................................................................................................... 495
46.1.2 Action Methods................................................................................................................495
46.2 Details............................................................................................................................... 496
46.2.2 Action Methods................................................................................................................496

Visual SCIL Objects
Section 47 VS_TREE.................................................................................................... 499

47.1 Overview........................................................................................................................... 499
47.1.2 Action Methods................................................................................................................499
47.2 Details............................................................................................................................... 501
47.2.2 Action Methods................................................................................................................501
Index.....................................................................................................................................513

Visual SCIL Objects
1MRK 511 548-UEN Rev. A Section 1
Copyrights
Section 1 Copyrights GUID-03127CB5-2F5A-4099-A5DC-20E63835472E v3
The information in this document is subject to change without notice and should not be construed as
a commitment by Hitachi Energy. Hitachi Energy assumes no responsibility for any errors that may
appear in this document.
In no event shall Hitachi Energy be liable for direct, indirect, special, incidental or consequential
damages of any nature or kind arising from the use of this document, nor shall Hitachi Energy be
liable for incidental or consequential damages arising from the use of any software or hardware
described in this document.
This document and parts thereof must not be reproduced or copied without written permission from
Hitachi Energy, and the contents thereof must not be imparted to a third party nor used for any
unauthorized purpose.
The software or hardware described in this document is furnished under a license and may be used,
copied, or disclosed only in accordance with the terms of such license.
Trademarks
ABB is a registered trademark of ABB Asea Brown Boveri Ltd. Manufactured by/for a Hitachi Energy
company. All other brand or product names mentioned in this document may be trademarks or
registered trademarks of their respective holders.
Guarantee
Please inquire about the terms of guarantee from your nearest Hitachi Energy representative.
Third Party Copyright Notices
List of Third Party Copyright notices are documented in "3rd party licenses.txt" and other locations
mentioned in the file in SYS600 and DMS600 installation packages.
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit.
(https://www.openssl.org/). This product includes cryptographic software written by Eric Young
(eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com).
This product includes software developed by Computing Services at Carnegie Mellon University
(http://www.cmu.edu/computing/).
This product includes software developed by vbAccelerator (/index.html).

Visual SCIL Objects
14
Introduction
Section 2 Introduction GUID-6F3C0EE1-952C-4780-8BAB-D6F28C638523 v1
2.1 Use of symbols GUID-C2600B91-8566-4D3B-932E-E655846A2FE4 v1
This publication includes warning, caution and information symbols where appropriate to point out
safety-related or other important information. It also includes tips to point out useful hints to the
reader. The corresponding symbols should be interpreted as follows:
Warning icon indicates the presence of a hazard which could result in personal
injury.
Caution icon indicates important information or a warning related to the concept

discussed in the text. It might indicate the presence of a hazard, which could result in
corruption of software or damage to equipment/property.
Information icon alerts the reader to relevant factors and conditions.
Tip icon indicates advice on, for example, how to design a project or how to use a
certain function.
Although warning hazards are related to personal injury, and caution hazards are associated with
equipment or property damage, it should be understood that operation of damaged equipment could,
under certain operational conditions, result in degraded process performance leading to personal
injury or death. Therefore, comply fully with all warnings and caution notices.
2.2 Intended audience GUID-B7F116C5-66D5-4592-B16D-854450B740C9 v1
This manual is intended for installation personnel, administrators and skilled operators to support
installation of the software.
2.3 Related documents GUID-37388E79-56FF-41BF-8788-E99E46B90970 v3
Name of the Manual Document ID

SYS600 10.3 Visual SCIL Application Design 1MRK 511 547-UEN
2.4 Document conventions GUID-7C6EA139-E805-4AC1-9F4E-D4C3812C9916 v1
The following conventions are used for the presentation of material:
• The words in names of screen elements (for example, the title in the title bar of a dialog, the
label for a field of a dialog box) are initially capitalized.
• Capital letters are used for file names.
• Capital letters are used for the name of a keyboard key if it is labeled on the keyboard. For
example, press the CTRL key. Although the Enter and Shift keys are not labeled they are written
in capital letters, e.g. press ENTER.
• Lowercase letters are used for the name of a keyboard key that is not labeled on the keyboard.
For example, the space bar, comma key and so on.

Visual SCIL Objects
Section 2 1MRK 511 548-UEN Rev. A
Introduction
• Press CTRL+C indicates that the user must hold down the CTRL key while pressing the C key
(in this case, to copy a selected object).
• Press ALT E C indicates that the user presses and releases each key in sequence (in this case,
to copy a selected object).
• The names of push and toggle buttons are boldfaced. For example, click OK.
• The names of menus and menu items are boldfaced. For example, the File menu.
• The following convention is used for menu operations: Menu Name/Menu Item/
Cascaded Menu Item. For example: select File/Open/New Project.
• The Start menu name always refers to the Start menu on the Windows Task Bar.
• System prompts/messages and user responses/input are shown in the Courier font. For
example, if the user enters a value that is out of range, the following message is displayed:
Entered value is not valid.
The user may be told to enter the string MIF349 in a field. The string is shown as follows in the
procedure: MIF349
• Variables are shown using lowercase letters: sequence name
2.5 Document revisions GUID-68EF15D6-2B0E-4B19-9AB4-8C21B73349DF v3
Revision Version number Date History

A 10.3 30.11.2021 New document for SYS600
10.3

Visual SCIL Objects
General properties
Section 3 General properties GUID-83F96271-8238-4C56-99FB-2E7592623FCE v1
3.1 Overview GUID-733AE9C2-9227-4DC4-9160-97C7450A267F v1
In this section, some general properties, such as attributes and methods, are described. The
properties described here are not described again together with the object types only listed in the
overview section if they exist.
3.1.1 Predefined attributes GUID-9E9CA07E-005C-46DD-ACB9-AB227509EFC7 v1
Name Type
"_ATTRIBUTE_NAMES" List
"_BACKGROUND_COLOR" Color
"_BACKGROUND_HILITE_COLOR" Color
"_CHILD_OBJECTS" Text vector
"_FILE_REVISION" Text
"_FONT" Font
"_FOREGROUND_COLOR" Color
"_GEOMETRY" List
"_MAX_HEIGHT" Integer
"_MAX_WIDTH" Integer
"_MIN_HEIGHT" Integer
"_MIN_WIDTH" Integer
"_OBJECT_CLASS" Text
"_OBJECT_NAME" Text
"_SCIL_GEOMETRY _SCIL_GEOMETRY" List
"_SOURCE_FILE_NAME" Text
"_VARIABLE_NAMES" Text vector
3.1.2 Predefined methods GUID-9353D1FB-DD6F-468D-B890-535040FDC816 v1
Name Type
"_FLAG_FOR_EXECUTION" No return value
"_GET_HELP" No return value
"_QUEUE_FOR_EXECUTION" No return value
"_SET_MAX_SIZE" No return value
"_SET_MIN_SIZE" No return value
3.2 Details GUID-42A79BDB-CF6A-4E97-A679-84219698FC69 v1
3.2.1 Predefined attributes GUID-DE39CF2C-44AB-4C5A-BB38-D341333ABFF9 v1
_ATTRIBUTE_NAMES
Contains the names of all attributes known to the object.

Visual SCIL Objects
General properties
Description: A list containing two text vector attributes,

USER_DEFINED and PREDEFINED. The attribute
USER_DEFINED is a text vector containing the names of
user-defined attributes, i.e. the attributes created
by .MODIFY command (or by .SET command in a picture
container context). The attribute PREDEFINED is a text
vector containing the names of the attributes defined by
the object class.
Data type: List
Default value: Environment dependent
Access: Read-only
Note: The attributes are listed in no particular order.
_BACKGROUND_COLOR
The background color of the object. This is the color that is used when drawing the background of the
object. If the color is not specified, it is inherited from the parent object.
Description: A color as represented in SCIL.

Data type: Color
Access: No limitations
_BACKGROUND_HILITE_COLOR
The background highlight color of the object. This is the color that is used when drawing the highlight
background of the object when the cursor is moved on the top of it.
Description: A color as represented in SCIL.

Data type: Color
_CHILD_OBJECTS
The names of the immediate children of the object listed in the order of creation.
Description: The names of the immediate children of the object.

Data type: Text vector
Access: Read-only
_FILE_REVISION
The revision text of the file from which the object/picture was loaded.

Visual SCIL Objects
General properties
Description: A character string containing up to 255 characters.

Data type: Text
Access: Read-only
_FONT
The font used when displaying texts in an object. If the font is set on an object which contains other
objects (dialogs, containers, etc.), the same font will be used in the contained object as well. If the
font is specifically set on one of the contained objects, this will not change.
Description: A font as represented in SCIL

Data type: Font
_FOREGROUND_COLOR
The foreground color of the object. This is the color that is used on e.g. titles and other texts in an
object. If the color is not specified it is inherited from the parent object.
Description: A color as represented in SCIL

Data type: Color
_GEOMETRY
The size and position of the object in VS coordinates. The position is always relative to the parent
object. The position of dialogs is relative to the screen. The size of a dialog defines the content area
of the dialog excluding borders, title bars, etc. In all other cases the size is defined by the bounding
rectangle of the object including possible borders, scrollbars etc. This attribute cannot always be set
freely due to restrictions based on possibly defined minimum or maximum sizes or automatic
geometry management.
Description: A list containing the attributes X, Y, W, H, representing

the position horisontally (X) and vertically (Y) as well as
the width (W) and height (H), all according to the VS
coordinate system.
Data type: List
Default value: Object dependent
_MAX_HEIGHT
Specifies the maximum height of the object. This restricts both user and programmatic manipulation
of the object. The value can be set by means of the _SET_MAX_SIZE method.

Visual SCIL Objects
General properties
Description: The maximum height in VS coordinates.

Data type: Integer
Default value: 32767
Access: Read-only
_MAX_WIDTH
Specifies the maximum width of the object. This restricts both user and programmatic manipulation of
the object. The value can be set by means of the _SET_MAX_SIZE method.
Description: The maximum width in VS coordinates.

Data type: Integer
Default value: 32767
Access: Read-only
_MIN_HEIGHT
Specifies the minimum height of the object. This restricts both user and programmatic manipulation
of the object. The value can be set by means of the _SET_MIN_SIZE method.
Description: The minimum height in VS coordinates.

Data type: Integer
Default value: 0
Access: Read-only
_MIN_WIDTH
Specifies the minimum width of the object. This restricts both user and programmatic manipulation of
the object. The value can be set by means of the _SET_MIN_SIZE method.
Description: The minimum width in VS coordinates.

Data type: Integer
Default value: 0
Access: Read-only
_OBJECT_CLASS
Specifies the name of the class of the object. If the object is a window or picture function, the
attribute has value "WINDOW" or "PICTURE_FUNCTION", respectively.

Data type: Text
Access: Read-only
_OBJECT_NAME

Visual SCIL Objects
General properties
Specifies the name of the object.

Data type: Text
Access: Read-only
_SCIL_GEOMETRY
The size and position of the object in SCIL coordinates. The position is always relative to the parent
object. The position of dialogs is relative to the screen. The size of a dialog defines the content area
of the dialog excluding borders, title bars, etc. In all other cases the size is defined by the bounding
rectangle of the object including possible borders, scrollbars etc. This attribute cannot always be set
freely due to restrictions based on possibly defined minimum or maximum sizes or automatic
geometry management.
Description: A list containing the attributes X, Y, W, H, representing

the posi-tion horisontally (X) and vertically (Y) as well as
the width (W) and height (H), all according to the SCIL
coordinate system.
Data type: List
_SOURCE_FILE_NAME
The full operating system format name of the "vso" file where the object has been loaded from or the
full name of the "pic" file where the window or picture function has been read from. Value is an empty
string, if the object is created on-the-fly, i.e. using .CREATE, !WIN_NAME or !WIN_CREATE.

Data type: Text
Access: Read-only
_VARIABLE_NAMES
The names of SCIL variables defined in the SCIL context that the object belongs to.
Description: A text vector containing the variable names.

Access: Read-only
Note: The names are listed in no particular order.
3.2.2 Predefined methods GUID-D49DD0B4-8B28-45C8-A802-F174C8987681 v1
_FLAG_FOR_EXECUTION

Visual SCIL Objects
General properties
This method is used when the programmer wants to execute a SCIL program at a later point in time
when the system is idle. An identifier for the flagged execution, as well as the program to be
executed, are given as parameters in the method call. An empty text value is allowed for the
identifier. There is no way to exactly know when in time the program is executed. However, a
minimum time that have to expire before execution can be defined in seconds as an optional third
parameter in the method call. If _FLAG_FOR_EXECUTION method of an object is called twice using
the same name, the first flagged execution is cancelled if not yet done.
Below is an example that shows how to ensure that the blocking cursor of a dialog is switched off
after a long program execution even if an error interruping the normal program flow occurs.
...
my_dialog._flag_for_execution("unblock", ".set my_dialog._blocked =

false")
.set my_dialog._blocked = true
;long SCIL processing here
...
Return value data type: No return value
Parameter(s):
NAME Text value used as the identifier of the flagged execution

PROGRAM Text or Text vector, thr program to be executed
DELAY Real, the minimum delay in seconds
_GET_HELP
Requests help for the object. Executing this method is equal to pressing the help button (F1 on MS-
Windows look and feel) when the object is in focus.
_QUEUE_FOR_EXECUTION
This method is used when the programmer wants to execute a SCIL program at a later point in time
when the system is idle. The program to be executed is given as a parameter in the method call.
There is no way to exactly know when in time the program is executed. However, a minimum time
that has to expire before execution can be defined in seconds as an optional second parameter in
the method call. The maximum number of queued programs per object is 100. If this limit is
exceeded, all queued executions are re-moved and a SCIL error is produced.
Below is an example that shows how to ensure that the blocking cursor of a dialog is switched off
after a long program execution even if an error interrupting the normal program flow occcurs.
...
my_dialog._queue_for_execution(".set my_dialog._blocked = false")
.set my_dialog._blocked = true
;long SCIL processing here
...

Visual SCIL Objects
General properties
Parameter(s):
PROGRAM Text or Text vector, the program to be executed

DELAY Real, the minimum delay in seconds
_SET_MAX_SIZE
Sets the maximum size of the object. This restricts both user and programmatic manipulation of the
object size.
Parameter(s):
WIDTH Integer, width in VS coordinates

HEIGHT Integer, height in VS coordinates
_SET_MIN_SIZE
Sets the minimum size of the object. This restricts both user and programmatic manipulation of the
object size.
Parameter(s):
WIDTH Integer, width in VS coordinates

HEIGHT Integer, height in VS coordinates

Visual SCIL Objects
24
VS_BOX
Section 4 VS_BOX GUID-7F94424D-1A67-4AF2-AF05-DBEF2196EC0B v1
4.1 Overview GUID-F5CF02A1-7D9D-4503-98D8-89C651AF2242 v1
The VS_BOX item is a simple dialog item that does not contain any functionality. The object
visualises a box that can be used to visually group related interface objects together. When a
functional grouping of objects is desired, the container should be used instead of the box. The box
can also be used to accommodate a VS_IMAGE. The appearance of the box depends on the current
platform.
4.1.1 Action Attributes GUID-BB0987E6-256F-4951-A4B1-FF3EFC88A101 v1
Name Type
"_GET_TABLE_EDIT_TEXT" Text vector
"_GET_TABLE_VIEW_TEXT" Text vector
"_TOOLTIP_IS_SHOWN" Text vector
"_UPDATE_TABLE_EDIT_TEXT" Text vector
"_UPDATE_TABLE_VIEW_TEXT" Text vector
4.1.2 Action Methods GUID-588342C0-6936-47DF-B9AE-13FD187D6D51 v1
Name Type
"GET_TABLE_EDIT_TEXT" Text
"GET_TABLE_VIEW_TEXT" Text
"TOOLTIP_IS_SHOWN" No return value
"UPDATE_TABLE_EDIT_TEXT" No return value
"UPDATE_TABLE_VIEW_TEXT" No return value
4.1.3 Predefined Attributes GUID-186F9577-A5A4-43D8-A49D-CB7B357584B3 v1
Name Type
"_ENABLED" Boolean
"_FONT" Font
_"_FOREGROUND_COLOR" Color
"_GEOMETRY" List
"_HAS_BORDER" Boolean
"_HAS_IMAGE_MASK" Boolean
"_IMAGE" Image reference
"_OBJECT_NAME" Text
"_SCIL_GEOMETRY" List
Table continues on next page

Visual SCIL Objects
VS_BOX
"_TITLE" Text
"_TOOLTIP_TEXT" Text
"_VISIBLE" Boolean
4.1.4 Predefined Methods GUID-24C6D9A5-C541-429B-8BA2-784965EABE35 v1
Name Type
"_GET_STRING_WIDTH" Integer
4.2 Details GUID-B7129A41-595C-4B8E-8D2F-E1F26AB7EE77 v1
4.2.1 Action Attributes GUID-763BA09A-6407-49ED-8CEF-7083BCF14D38 v1
_GET_TABLE_EDIT_TEXT
Setting this attribute specifies the action method GET_TABLE_EDIT_TEXT.
_GET_TABLE_VIEW_TEXT
Setting this attribute specifies the action method GET_TABLE_VIEW_TEXT.
_TOOLTIP_IS_SHOWN
Setting this attribute specifies the action method TOOLTIP_IS_SHOWN.
_UPDATE_TABLE_EDIT_TEXT
Setting this attribute specifies the action method UPDATE_TABLE_EDIT_TEXT.
_UPDATE_TABLE_VIEW_TEXT
Setting this attribute specifies the action method UPDATE_TABLE_VIEW_TEXT.

Visual SCIL Objects
VS_BOX
4.2.2 Action Methods GUID-E958665A-0E29-48ED-8A5A-3D78B13DE313 v1
GET_TABLE_EDIT_TEXT
This action method is executed whenever the table needs a value from an edit object. This method is
executed just before the edit object of the cell is closed (i.e. just before the
CELL_EDITING_ACCEPTED action method). This function can be used, for example, to convert
internal edit object value to text value, which is stored in the cell. This action method is called with
two parameters: ROW and COLUMN of the current cell. This action method should return a text
string.
Data type to be returned: Text
GET_TABLE_VIEW_TEXT
This action method is executed whenever the table needs the value for the view object of the current
cell. For example, this method is executed when the view object is drawn into the cell. This function
can be used, for example, to convert edit object value of the cell to the text value of the cell.
TOOLTIP_IS_SHOWN
This action method is executed whenever a tooltip is shown over a dialog item.
Data type to be returned: No return value
UPDATE_TABLE_EDIT_TEXT
This action method is executed whenever the edit object of the cell needs a value to be shown. This
method is executed just before the editing of the cell is started (just after the
CELL_EDITING_STARTED action method). This action method has three parameters: ROW and
COLUMN of the cell and the text of the cell. This action method could be used to convert the text
value of the view object to the edit object value.
UPDATE_TABLE_VIEW_TEXT
This action method is executed whenever the table needs a value for the view object. This method is
executed just before the view object of the cell is drawn. This function can be used, for example, to
convert the text value of the cell to the current value of the view object, which is shown in the view
object. This action method has three parameters: ROW and COLUMN of the cell and the TEXT of
the cell.

Visual SCIL Objects
VS_BOX
4.2.3 Predefined Attributes GUID-76ACD660-EA54-4386-A5EA-E99AC0976F3F v1
_ATTRIBUTE_NAMES
For more information, see Section 3.
_BACKGROUND_COLOR
Example:
.SET MY_OBJECT._BACKGROUND_COLOR = (65535, 65535, 65535)
_CHILD_OBJECTS
_ENABLED
Specifies whether the dialog item responds to various events. A change of appearance is also often
combined with this attribute. When setting this attribute to FALSE, the disabled dialog item is
displayed as dimmed.
Description: A value of TRUE or FALSE.

Data type: Boolean
Default value: TRUE
Example:
.SET MY_OBJECT._ENABLED = FALSE
_FILE_REVISION
_FONT
Example:
.SET MY_OBJECT._FONT = (“M“, 1)
_FOREGROUND_COLOR
Example:
.SET MY_OBJECT._FOREGROUND_COLOR = (65535, 0, 0)

Visual SCIL Objects
VS_BOX
_GEOMETRY
Example:
.SET MY_OBJECT._GEOMETRY = LIST(X = 10, Y = 10, W = 100, H = 100)
_HAS_BORDER
Determines whether the box item should be drawn with a border or not.

Data type: Boolean
Default value: TRUE
Example:
.SET MY_OBJECT._HAS_BORDER = FALSE
_HAS_IMAGE_MASK
Specifies whether the image of the dialog item is drawn as a mask for the item foreground color or
not. If this attribute is TRUE, the background of the dialog item is visible through the image. Note that
not all dialog items can contain an image.

Data type: Boolean
Default value: FALSE
Example:
.SET MY_OBJECT._HAS_IMAGE_MASK = TRUE
_IMAGE
Specifies an image that is associated with the object. The way that the image is displayed depends
on the object. The image is given as an object reference to an image that has been loaded or created
as an independent object.
Description: A reference to a VS_IMAGE object. A VS_IMAGE can be

created using the SCIL function .CREATE or loaded
using the function .LOAD.
Data type: Image reference
Default value: Empty text
Example:
.LOAD ROOT\ IMAGE1 = VS_IMAGE(“...

Visual SCIL Objects
VS_BOX
_OBJECT_CLASS
_OBJECT_NAME
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TITLE
Specifies the title of the dialog item.

Data type: Text
Example:
.SET MY_OBJECT._TITLE = “Tool Properties“
_TOOLTIP_TEXT
Specifies a tooltip text that appears over the object when the cursor is stopped.
Data type: Text
Example:
.SET MY_OBJECT._TOOLTIP_TEXT = “Tool Properties”
_VARIABLE_NAMES
_VISIBLE
Specifies whether the dialog item is visible or not. Setting this attribute to FALSE may be useful if a
dialog item should be invisible when opening the dialog.

Visual SCIL Objects
VS_BOX

Data type: Boolean
Default value: TRUE
Example:
.SET MY_OBJECT._VISIBLE = FALSE
4.2.4 Predefined Methods GUID-8D5F2714-07E5-4E4B-8E23-624BE1774395 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH
Returns the width of the given string in the current font of the object.
Return value data type: Integer
Parameter(s)
STRING Text
A character string containing up to 255 characters.

Visual SCIL Objects
32
VS_BUTTON
Section 5 VS_BUTTON GUID-7E581593-BF0E-40CB-8FA4-707A7079E46B v1
5.1 Overview GUID-DA9F97D7-F398-4641-A76E-4847B8D052D9 v1
A VS_BUTTON is a dialog item that can activate a command but have no value. In order to be
useful, a button needs the action method NOTIFY that is executed when the user clicks the button. A
button is activated when the user clicks the button. Buttons can also be activated by pressing certain
keys in the keyboard that depend on the current look-and-feel. The button can be used to
accommodate a VS_IMAGE.
5.1.1 Action Attributes GUID-BA149DD4-8348-44AE-A3B2-4CF611F9C1B6 v1
Name Type
"_NOTIFY" Text vector
"_TOOLTIP_IS_SHOWN" Text Vector
5.1.2 Action Methods GUID-829A87F1-4BC3-4D6A-A38E-0DE65BC38670 v1
Name Type
"NOTIFY NOTIFY" No return value
5.1.3 Predefined Attributes GUID-B7489D48-F87E-48FB-9147-57157D8D11BB v1
Name Type
"_ALIGNMENT" Text
"_CLICK_FOCUSABLE" Boolean
"_ENABLED" Boolean
"_FOCUSABLE" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List

Visual SCIL Objects
VS_BUTTON
"_HAS_FLAT_APPEARANCE" Boolean
"_MNEMONIC" Text
"_OBJECT_NAME" Text
"_POP_UP_MENU" Menu reference
"_TITLE" Text
"_TITLE_VECTOR" Text vector
"_VISIBLE" Boolean
5.1.4 Predefined Methods GUID-1ABF8740-C911-447A-98EC-9365A4C1E55A v1
Name Type
5.2 Details GUID-10483C41-79DE-45E3-B040-3E9327BEA6F2 v1
5.2.1 Action Attributes GUID-AA891F37-21BB-4AA4-93FE-7F1E3B3F042F v1
_NOTIFY
Setting this attribute specifies the action method NOTIFY.

Visual SCIL Objects
VS_BUTTON
Example:
.SET MY_OBJECT._NOTIFY = (“ROOT.OPEN_EDIT_DIALOG“, ““)
_TOOLTIP_IS_SHOWN
5.2.2 Action Methods GUID-EEF43396-8599-4BA9-B844-D629575977A5 v1
GET_TABLE_EDIT_TEXT
executed just before the edit object of the cell is closed (just before the CELL_EDITING_ACCEPTED
action method). This function can be used, for example, to convert internal edit object value to text
value, which is stored in the cell. This action method is called with two parameters: ROW and
COLUMN of the current cell. This action method should return a text string.
GET_TABLE_VIEW_TEXT
NOTIFY
The NOTIFY action method is executed when a button is clicked or otherwise activated.
When the button has a _POP_UP_MENU, the NOTIFY action method will not be
called.
TOOLTIP_IS_SHOWN
This action method is executed whenever a tooltip is shown over the dialog item.

Visual SCIL Objects
VS_BUTTON
COLUMN of the cell and the text of the cell. This action method can be used to convert the text value
of the view object to the edit object value.
the cell.
5.2.3 Predefined Attributes GUID-03261BDE-DEAE-4F4E-B97D-FC9C39ACEF90 v1
_ALIGNMENT
Specifies the multiline title alignment.
Description: A value of “LEFT” Or “RIGHT” Or “CENTER”.

Data type: Text
Default value: Center
Example:
.set ._ALIGNMENT=”RIGHT”
_ALIGNMENT is applicable only for VS_BUTTON with multiline titles
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS

Visual SCIL Objects
VS_BUTTON
_CLICK_FOCUSABLE
Specifies whether the dialog item receives focus when it is clicked.

Data type: Boolean
Example:
.SET MY_OBJECT._CLICK_FOCUSABLE = FALSE
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE
Specifies whether the dialog item receives focus during normal keyboard traversal.

Data type: Boolean
Default value: TRUE
Example:
.SET MY_OBJECT._FOCUSABLE = FALSE
_FOCUSED
Contains the value TRUE if the dialog item has the keyboard focus.

Visual SCIL Objects
VS_BUTTON

Data type: Boolean
Access: Read-only
Example:
@HAS_FOCUS = MY_OBJECT._FOCUSED
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_HAS_BORDER
Determines whether the dialog item should be drawn with a border or not. The exact interpretation of
this attribute is dependent on the object type.

Data type: Boolean
Default value: TRUE
Example:
_HAS_FLAT_APPEARANCE
Determines whether the VS_BUTTON should be drawn Flat or not.

Visual SCIL Objects
VS_BUTTON

Data type: Boolean
Example:
.SET MY_BUTTON._HAS_FLAT_APPEARANCE = TRUE
Flat appearance is applicable only for VS_BUTTON with image. The feature is
implemented targeting Toolbar buttons. Flat Appearance is visible only for tools
opened in Modern LAF.
_HAS_IMAGE_MASK
Specifies whether the image of the dialog item is drawn as a mask for the item foreground color or
not. If this attribute is, the background of the dialog item is visible through the image. Note that not all
dialog items can contain an image.

Data type: Boolean
Example:
_IMAGE
on the object. The image is given as an object reference to the image that has been loaded or
created as an independent object.

Example:
_MNEMONIC
Specifies the mnemonic character of the dialog item. The mnemonic may be visualized differently on
different platforms.

Visual SCIL Objects
VS_BUTTON
Description: A character string containing 1 character.

Data type: Text
Default value: ASCII(0)
Example:
.SET MY_OBJECT._MNEMONIC = “A“
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
Specifies a pop-up menu that is associated with the object. This menu is activated by right-clicking
the object.
When the _POP_UP_MENU is defined, the action method _NOTIFY won' t be

executed.
Description: A reference to a VS_MENU object. A VS_MENU can be

created using the SCIL function .CREATE or loaded from
a file using the function .LOAD.
Data type: Menu reference
Example:
.LOAD ROOT\ MENU1 = VS_MENU(“...
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TITLE

Visual SCIL Objects
VS_BUTTON

Data type: Text
Example:
_TITLE_VECTOR
Specifies a multiline title text of the button item.
Description: A vector containing only text elements.

Data type: Vector
Default value: Empty vector
Example:
.SET MY_OBJECT._TITLE_VECTOR = vector(“title line1“,“title line1“,“title

line3“)
_TOOLTIP_TEXT
Specifies a tooltip text that appears over the object when the cursor is brought over it.
Data type: Text
Example:
_VARIABLE_NAMES
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:

Visual SCIL Objects
VS_BUTTON
5.2.4 Predefined Methods GUID-B59F66B1-E5A1-4974-838B-8A5F9C303235 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH
Parameter(s)
STRING Text

Visual SCIL Objects
VS_CHECK_BOX
Section 6 VS_CHECK_BOX GUID-AA469840-47EE-43FD-95E4-D27D97EE949B v1
6.1 Overview GUID-021DE686-FF12-4D5C-BC85-187F31775BC9 v1
A VS_CHECK_BOX object is an object that can be selected or cleared (deselected). The

appearance of the object is dependent on the graphics platform. The attribute _VALUE contains the
current state of the check box. The NOTIFY action method is called whenever the check box is
clicked.
6.1.1 Action Attributes GUID-E8546FC4-EB63-41F2-8D57-4285D1E54A34 v1
Name Type
6.1.2 Action Methods GUID-C0E4B9DE-21D7-47DF-A45F-F96E94BE0186 v1
Name Type
"NOTIFY" No return value
6.1.3 Predefined Attributes GUID-02F61C75-CB2F-4756-8E0E-DED7EA000742 v1
Name Type
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_MNEMONIC" Text

Visual SCIL Objects
VS_CHECK_BOX
"_OBJECT_NAME" Text
"_TITLE" Text
"_VALUE" Integer
"_VISIBLE" Boolean
6.1.4 Predefined Methods GUID-F87564A0-6916-4C43-BF76-FEA43E020F27 v1
Name Type
6.2 Details GUID-DE0C20EF-119C-4BF7-B51D-74DAC24F213C v1
6.2.1 Action Attributes GUID-A9C2F8B2-F998-43B4-9D38-3829876FDAA7 v1
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_CHECK_BOX
6.2.2 Action Methods GUID-4AF675E9-D8FF-4FF2-A17C-F4272B040BF6 v1
GET_TABLE_EDIT_TEXT
GET_TABLE_VIEW_TEXT
NOTIFY
Specifies the notification procedure of the dialog item. The notification procedure gets called for
different reasons with different dialog items. See the general object description for a description of
NOTIFY for a specific object.
TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_CHECK_BOX
the cell.
6.2.3 Predefined Attributes GUID-A41E3069-D96F-4918-986F-8067F64D4901 v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE
Data type: Boolean

Example:
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION

Visual SCIL Objects
VS_CHECK_BOX
_FOCUSABLE
Description: A value of TRUE or FALSE

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_MNEMONIC

Visual SCIL Objects
VS_CHECK_BOX

Data type: Text
Example:
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
Specifies the pop-up menu that is associated with the object. This menu is activated by right-clicking
the object.

Example:
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TITLE

Data type: Text
Example:
_TOOLTIP_TEXT
Specifies a tooltip text that appears over the object when the cursor is held over it.

Visual SCIL Objects
VS_CHECK_BOX
Data type: Text
Example:
_VALUE
Indicates the current value of the control object.
Description: An integer value.

Data type: Integer
Default value: 0
Example:
.SET MY_CONTROL._VALUE = 1
_VARIABLE_NAMES
_VISIBLE
Specifies whether the dialog item is visible or not. Setting this attribute to FALSE may be useful if the

Data type: Boolean
Default value: TRUE
Example:
6.2.4 Predefined Methods GUID-AFC56272-3E73-4864-9DF1-9871E899F03A v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH
Parameter(s)
STRING Text

Visual SCIL Objects
VS_CHECK_BOX

Visual SCIL Objects
VS_COMBO
Section 7 VS_COMBO GUID-CB5B35A0-DA1A-4A60-8B54-A6DDCB3F183E v1
7.1 Overview GUID-59161D24-0850-4A8D-A3B1-EA0E3DA29072 v1
A VS_COMBO is a dialog item that enables the user to pick a selection from a list of choices. These
choices can be defined by the application or entered by the user. A combination box has three
associated behaviours: accept, select, and scroll situations. The behaviour of a combination box
affects how the combination box maps user input (typing in the entry box or selecting from the choice
box, for example) to a value in its list of values. Note that the default definition of these behaviours
may vary according to look-and-feel. The indexing in combo box begins from 1.
7.1.1 Action Attributes GUID-68912510-2415-4218-93D7-875E70B466D2 v1
Name Type
"_ACCEPT" Text vector
"_SELECT" Text vector
7.1.2 Action Methods GUID-6B5210FB-B684-4CC1-93EF-AAD4F969849A v1
Name Type
"ACCEPT" No return value
"SELECT" No return value
7.1.3 Predefined Attributes GUID-8F4C8A32-9F92-4300-A1A7-9A1690C983EB v1
Name Type
"_ACCEPT_BEHAVIOR" Text
"_AUTO_SORT_ENABLED" Boolean
"_CASE_SENSITIVITY_ENABLED" Boolean
_"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_MODIFIABLE" Boolean
"_OBJECT_NAME" Text

Visual SCIL Objects
VS_COMBO

"_SCROLL_BEHAVIOR" Text
"_SELECT_BEHAVIOR" Text
"_SELECTED_INDEX" Integer
"_TEXT" Text
"_VALUE_COUNT" Integer
"_VISIBLE" Boolean
"_WRAP_ENABLED" Boolean
7.1.4 Predefined Methods GUID-EC65D8FE-5A84-47A9-8717-21B7DF960847 v1
Name Type
"_APPEND_TEXT" No return value
"_DELETE_TEXT_AT" No return value
"_GET_TEXT_AT" Text
"_MOVE_TEXT" No return value
"_SELECT_TEXT_RANGE" No return value
7.2 Details GUID-24998961-19F1-4CCA-96A4-530A13E1AA26 v1
7.2.1 Action Attributes GUID-BCF9CD5E-4E5A-41C6-A151-76A47E047015 v1
_ACCEPT
Setting this attribute specifies the action method ACCEPT.
_SELECT
Setting this attribute specifies the action method SELECT.
_TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_COMBO
7.2.2 Action Methods GUID-324BC42C-8A43-4B76-965B-E9BA259E28F0 v1
ACCEPT
The ACCEPT action method is executed whenever an accept situation has occurred.
SELECT
The SELECT action method is executed whenever a select situation has occurred.
TOOLTIP_IS_SHOWN
7.2.3 Predefined Attributes GUID-BB9C09EE-F86A-46A0-97DB-93498993C118 v1
_ACCEPT_BEHAVIOR
This attribute specifies how the combination box behaves in an accept situation. An accept situation
is when the combination box makes the selected (or entered) value the current value. This occurs
when the user presses Return or Enter, or when the focus leaves the combination box. Note the
_ACCEPT_BEHAVIOR attribute concerns only to a modifiable combination box, also the action
method ACCEPT is not executed if the combination box attribute _MODIFIABLE is set to FALSE and
a selection is made from the combination box.

Visual SCIL Objects
VS_COMBO
Description: A text string containing one of the following keywords:

MATCH_OR_ADD, MATCH_OR_CLOSEST,
MATCH_OR_PARTIAL, MATCH_OR_FIRST,
MATCH_OR_NOTHING, MATCH_OR_REVERT and
DEFAULT.
MATCH_OR_ADD: If any value is entered in the entry
box and ENTER is pressed, the value will get added to
the selection box.
MATCH_OR_CLOSEST: If a value is entered in the entry
box and ENTER is pressed, the closest value (Next
number if it is numeric, closest string if it is alphabets)
present is given.
MATCH_OR_PARTIAL: If any value is entered in the
entry box and ENTER is pressed, the partially matched
value from the selection list is selected.
MATCH_OR_FIRST: If any value is entered in the entry
box and ENTER is pressed, the first value from the
selection list is selected if no match is found. Otherwise,
the match value is selected.
MATCH_OR_NOTHING: If any value is entered in the
entry box and ENTER is pressed but no match is found,
no selection is made but the value will remain in the entry
box (only).
MATCH_OR_REVERT: If any value is entered in the
entry box and ENTER is pressed, the previously selected
value will be selected if no match is found.
DEFAULT:If any value is entered in the entry box and
ENTER is pressed, the partially matched value from the
selection list is selected.
Data type: Text
Default value: "DEFAULT"
_ATTRIBUTE_NAMES
_AUTO_SORT_ENABLED
Specifies whether the combo box list should be automatically sorted in alphabetical order.

Data type: Boolean
Example:
.SET MY_COMBO._AUTO_SORT_ENABLED = TRUE
_BACKGROUND_COLOR
Example:
_CASE_SENSITIVITY_ENABLED
If this attribute value is FALSE, the upper or lower case letters are ignored when comparing two
values. If this value is TRUE, the case is significant.

Visual SCIL Objects
VS_COMBO

Data type: Boolean
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:

Visual SCIL Objects
VS_COMBO
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_MODIFIABLE
Specifies if the user is allowed to type into the entry box of the combo box. A change of appearance
is also often combined with this attribute.

Data type: Boolean
Default value: TRUE
Example:
.SET MY_COMBO._MODIFIABLE = FALSE
_OBJECT_CLASS
_OBJECT_NAME

Visual SCIL Objects
VS_COMBO
_POP_UP_MENU
the object.

Example:
_SCIL_GEOMETRY
_SCROLL_BEHAVIOR
This attribute specifies how the combination box behaves in a scroll situation. A scroll situation is
when the list in the choice box is scrolled. If the user types in the entry box, for every keystroke
(except Return and ENTER), a scroll situation is triggered as the combination box tries to match a
choice box value to the entry box value (depending on behavior).

DEFAULT.
box and ENTER is pressed, it will scroll to that entry.
MATCH_OR_CLOSEST: If value is entered in the entry
box and ENTER is pressed, it will scroll to the closest
value (next number if the vauel is numeric, closest string
if the value is texts).
entry box and ENTER is pressed, the partially matched
value from the selection list is scrolled to view.
selection list is scrolled to view if no match is found.
entry box and ENTER is pressed, no scrolling is done if
no match is found.
entry box and ENTER is pressed, the view scrolls to
previously selected value if no match is found.
ENTER is pressed, the partially matched value from the
selection list is scrolled to view.
Data type: Text
_SELECT_BEHAVIOR
This attribute specifies how the combination box behaves in a select situation. A select situation is
when the combination box tries to map user input to a value. This occurs when the user selects a

Visual SCIL Objects
VS_COMBO
value from the choice box or enters text into the entry box. Every keystroke in the entry box (with the
exception of Return and ENTER) triggers a select situation.

DEFAULT.
box and ENTER is pressed, the new entry will be
selected.
box and ENTER is pressed, the closest value will be
selected (the next number if the value is numeric, the
closest string if the value is text).
entry box and ENTER is pressed, partially matched value
is selected.
selection list is selected if no match is found.
entry box and ENTER is pressed, the value is selected if
no match is found.
ENTER is pressed, partially matched value is selected.
Data type: Text
_SELECTED_INDEX
Specifies the index of the selected value in the combo box.

Data type: Integer
Default value: 0
_SOURCE_FILE_NAME
_TEXT
Specifies the current text string in the input field of the VS_COMBO object.

Data type: Text
_TOOLTIP_TEXT
Specifies a tooltip text that appears over the object when the cursor is held over the object.

Visual SCIL Objects
VS_COMBO
Data type: Text
Example:
_VALUE_COUNT
The number of values in the list of values in the combo box.

Data type: Integer
Default value: 0
Access: Read-only
_VARIABLE_NAMES
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
_WRAP_ENABLED
Specifies whether the selection in the combo box list wraps around when the beginning or the end is
reached using, for example, the arrow keys to traverse the list.

Data type: Boolean
Example:
.SET MY_COMBO._WRAP_ENABLED = FALSE
7.2.4 Predefined Methods GUID-4F638D94-F671-4305-8F64-2FD470A56CB0 v1
_APPEND_TEXT
Appends a text string to the list in the combo box. If the attribute _AUTO_SORT_ENABLED is set to
TRUE, the list of texts is automatically resorted when a new text string is appended. Otherwise, the
new text string is appended to the end of the list.

Visual SCIL Objects
VS_COMBO

Parameter(s)
STRING Text
_DELETE_TEXT_AT
Deletes the text string at the specified index.

Parameter(s)
INDEX Integer
An integer value.
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_GET_TEXT_AT
Returns the text string at the specified index.
Return value data type: Text

Parameter(s)
INDEX Integer
An integer value.
_MOVE_TEXT
Moves a text string from an index to another in the combo box list of texts.

Parameter(s)
FROM Integer
An integer value.
TO Integer
An integer value.

Visual SCIL Objects
VS_COMBO
_SELECT_TEXT_RANGE
Selects the range of text in the input field of a combo object or places the cursor in the text. When the
start parameter is 1, the starting position for the selection is before the first character. When the start
parameter is -1, the starting position for the selection is after the last character. Length parameter 0
indicates the placing of the cursor without selecting any characters. A positive length parameter
defines the amount of selected characters to the right from starting point. A negative length
parameter defines the amount of selected characters to the left from starting point. The length
parameter is automatically truncated to the length of the text.

Parameter(s)
START Integer
An integer value.
LENGTH Integer
An integer value.

Visual SCIL Objects
62
VS_COMBO_POPDOWN
Section 8 VS_COMBO_POPDOWN GUID-57A46711-966C-4264-A5D0-C6C6DD44F5B3 v1
8.1 Overview GUID-03D8C0E7-CEEC-4EA4-89CD-CC155EC9A998 v1
A VS_COMBO_POPDOWN box is a dialog item that enables the user to pick a selection from a list
of choices. These choices can be defined by the application or entered by the user. A combination
box has three associated behaviours: accept, select, and scroll situations. The defined behaviour of a
combination box affects how the combination box maps user input (typing in the entry box or
selecting from the choice box, for example) to a value in its list of values. Note that the default
definition of these behaviours may vary according to look-and-feel. The indexing in combo popdown
begins from 1.
8.1.1 Action Attributes GUID-1E508BA4-588D-486C-8FAF-211FCDBFBB9D v1
Name Type
"_ACCEPT" Text vector
"_SELECT" Text vector
8.1.2 Action Methods GUID-0CDB75E6-A9AA-48F6-8853-4AB9F2821266 v1
Name Type
"ACCEPT" No return value
"SELECT" No return value
8.1.3 Predefined Attributes GUID-6A8145CB-44AA-4590-AA62-AA152F268050 v1
Name Type
"_ACCEPT_BEHAVIOR" Text
"_CASE_SENSITIVITY_ENABLED" Boolean
"_ENABLED" Boolean

Visual SCIL Objects
VS_COMBO_POPDOWN
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_OBJECT_NAME" Text
"_SCROLL_BEHAVIOR" Text
"_SELECT_BEHAVIOR" Text
"_TEXT" Text
"_VALUE_COUNT" Integer
"_VISIBLE" Boolean
"_VISIBLE_VALUE_COUNT" Integer
8.1.4 Predefined Methods GUID-7BB0C9BF-6644-489B-B35F-20FC6B96818F v1
Name Type
"_GET_TEXT_AT" Text
"_MOVE_TEXT" No return value
8.2 Details GUID-C89148B6-A3DA-490A-9B14-F9FAED19B1DB v1
8.2.1 Action Attributes GUID-A991E58B-705E-4FC1-8C0A-46D0729E035C v1
_ACCEPT
Setting this attribute specifies the action method ACCEPT.

Visual SCIL Objects
VS_COMBO_POPDOWN
_SELECT
Setting this attribute specifies the action method SELECT.
_TOOLTIP_IS_SHOWN
8.2.2 Action Methods GUID-87446A8E-FAF5-44FF-9E85-B1E20534D141 v1
ACCEPT
The ACCEPT action method is executed whenever an accept situation has occurred.
GET_TABLE_EDIT_TEXT
GET_TABLE_VIEW_TEXT

Visual SCIL Objects
VS_COMBO_POPDOWN
SELECT
The SELECT action method is executed whenever a select situation has occurred.
TOOLTIP_IS_SHOWN
the cell.
8.2.3 Predefined Attributes GUID-F3CC68D0-9D71-48B0-97A8-5E7ACD1FDAD1 v1
_ACCEPT_BEHAVIOR
This attribute specifies how the combination box behaves in an accept situation. An accept situation
is when the combination box makes the selected (or entered) value the current value. This occurs
when the user presses Return or Enter, or when the focus leaves the combination box.

Visual SCIL Objects
VS_COMBO_POPDOWN

DEFAULT.
box and ENTER is pressed, the value will get added to
the selection box.
box and ENTER is pressed, the closest value (next
number if the value is numeric, closest string if the value
is text) present is given.
entry box and ENTER is pressed, partially matched value
from the selection list is selected.
selection list is selected if no match is found. Otherwise,
the match value is selected.
entry box and ENTER is pressed, no selection is made
but the value will remain in the entry box (only) if no
match is found.
ENTER is pressed, partially matched value from the
selection list is selected.
Data type: Text
_ATTRIBUTE_NAMES
_AUTO_SORT_ENABLED
Specifies whether the combo box list should be automatically sorted in alphabetical order.

Data type: Boolean
Example:
.SET MY_COMBO_POPDOWN._AUTO_SORT_ENABLED = FALSE
_BACKGROUND_COLOR
Example:
_CASE_SENSITIVITY_ENABLED
If this attribute value is FALSE, the upper or lower case letters are ignored when comparing two
values. If this value is TRUE, the case is significant.

Visual SCIL Objects
VS_COMBO_POPDOWN

Data type: Boolean
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_ENABLED
dimmed.

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:

Visual SCIL Objects
VS_COMBO_POPDOWN
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_MODIFIABLE
Specifies if the user is allowed to type into the entry box of the combo box. A change of appearance
is also often combined with this attribute.

Data type: Boolean
Default value: TRUE
Example:
.SET MY_COMBO_POPDOWN._MODIFIABLE = FALSE
_OBJECT_CLASS
_OBJECT_NAME

Visual SCIL Objects
VS_COMBO_POPDOWN
_POP_UP_MENU
the object.
When _MODIFIABLE==FALSE, the _POP_UP_MENU is disabled.

Example:
_SCIL_GEOMETRY
_SCROLL_BEHAVIOR
This attribute specifies how the combination box behaves in a scroll situation. A scroll situation is
when the list in the choice box is scrolled. If the user types in the entry box, for every keystroke
(except Return and ENTER), a scroll situation is triggered as the combination box tries to match a
choice box value to the entry box value (depending on behaviour).

DEFAULT.
Data type: Text
_SELECT_BEHAVIOR
This attribute specifies how the combination box behaves in a select situation. A select situation is
when the combination box tries to map user input to a value. This occurs when the user selects a
value from the choice box or enters text into the entry box. Every keystroke in the entry box (with the
exception of Return and ENTER) triggers a select situation.

DEFAULT.
Data type: Text

Visual SCIL Objects
VS_COMBO_POPDOWN
_SELECTED_INDEX
Specifies the index of the selected value in the combo popdown.

Data type: Integer
Default value: 0
_SOURCE_FILE_NAME
_TEXT
Specifies the current text string in the input field of the VS_COMBO_POPDOWN object.

Data type: Text
_TOOLTIP_TEXT
Data type: Text
Example:
_VALUE_COUNT
The number of values in the list of values in the combo box.

Data type: Integer
Default value: 0
Access: Read-only
_VARIABLE_NAMES
_VISIBLE
Specifies whether the dialog item is visible or not. Setting this attribute to FALSE may be useful if the

Visual SCIL Objects
VS_COMBO_POPDOWN

Data type: Boolean
Default value: TRUE
Example:
_VISIBLE_VALUE_COUNT
The number of simultaneously visible values in the list of the combo box.

Data type: Integer
Default value: 5
Example:
.SET MY_COMBO_POPDOWN._VISIBLE_VALUE_COUNT = 4
_WRAP_ENABLED
Specifies whether the selection in the combo box list wraps around when the beginning or the end is
reached using for example the arrow keys to traverse the list.

Data type: Boolean
Example:
.SET MY_COMBO_POPDOWN._WRAP_ENABLED = FALSE
8.2.4 Predefined Methods GUID-6D9E7EB7-C652-4302-9C2D-D5F3F6976171 v1
_APPEND_TEXT
Appends a text string to the popdown list of the combo box. If the attribute
_AUTO_SORT_ENABLED is set to TRUE, the list of texts is automatically resorted when the new
text string is appended. Otherwise, the new text string is appended to the end of the list.

Parameter(s)
STRING Text
_DELETE_TEXT_AT
Deletes the text string at the specified index.

Visual SCIL Objects
VS_COMBO_POPDOWN

Parameter(s)
INDEX Integer
An integer value.
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_GET_TEXT_AT
Returns the text string at the specified index.

Parameter(s)
INDEX Integer
An integer value.
_MOVE_TEXT
Moves a text string from an index to another in the combo box list of texts.

Parameter(s)
FROM Integer
An integer value.
TO Integer
An integer value.
_SELECT_TEXT_RANGE
Selects the range of text in the input field of a combo object or places the cursor in the text. When
start parameter is 1, the starting position for the selection is before the first character. When start
parameter is -1, the starting position for the selection is after the last character. Length parameter 0
indicates placing the cursor without selecting any characters. A positive length parameter defines the
amount of selected characters to the right from starting point. A negative length parameter defines
the amount of selected characters to the left from starting point. The length parameter is
automatically truncated to the length of the text.

Visual SCIL Objects
VS_COMBO_POPDOWN

Parameter(s)
START Integer
An integer value.
LENGTH Integer
An integer value.

Visual SCIL Objects
VS_CONTAINER
Section 9 VS_CONTAINER GUID-EC0BDFEE-4E0A-4DFE-97EF-DFEB93622B20 v1
9.1 Overview GUID-82305E5E-16A1-4979-91E9-C4BDE9092836 v1
A VS_CONTAINER is a dialog item that can contain other dialog items. The container itself must be
placed within a VS_DIALOG or a VS_MAIN_DIALOG. Containers can also be placed in other
containers to make up a hierarchy of containers as long as the top-level container is within a dialog.
Usually the group of functionally related dialog items are placed inside the VS_CONTAINER.
9.1.1 Action Attributes GUID-2BF02046-EDAB-44AF-9151-70A0E72BC666 v1
Name Type
9.1.2 Action Methods GUID-29A8E263-D2B9-475D-A140-0269272C3EDC v1
Name Type
9.1.3 Predefined Attributes GUID-9CD2E106-AAF8-44E4-93FC-C0DC3B75D249 v1
Name Type
"_ABANDON_ITEM" Dialog Item
"_BOUNDS_GEOMETRY" List
"_CONFIRM_ITEM" Dialog Item
"_CONTENT_GEOMETRY" List
"_DEFAULT_FOCUS_ITEM" Dialog Item
"_ENABLED" Boolean
"_FLAT_KEYBOARD_TRAVERSAL_ENABLED" Boolean

Visual SCIL Objects
VS_CONTAINER
"_FOCUS_ITEM" Dialog Item

"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_HORIZONTAL_SCROLL_BAR_ENABLED" Boolean
"_ITEM_COUNT" Integer
"_OBJECT_NAME" Text
"_TITLE" Text
"_VERTICAL_SCROLL_BAR_ENABLED" Boolean
"_VISIBLE" Boolean
9.1.4 Predefined Methods GUID-42E2252E-7FBA-4609-B9F7-CD597E4F2ECA v1
Name Type
"_GET_ITEM_INDEX" Integer
"_SET_ITEM_INDEX" No return value
9.2 Details GUID-AED29798-DA0C-4BF4-BDF7-2B7593E01260 v1
9.2.1 Action Attributes GUID-DBF8A342-5272-494C-9DC6-1A66B27242EA v1

Visual SCIL Objects
VS_CONTAINER
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN
9.2.2 Action Methods GUID-D13AF135-7AD8-487E-BA46-7F26AC99F437 v1
GET_TABLE_EDIT_TEXT
GET_TABLE_VIEW_TEXT
NOTIFY
Specifies the notification procedure of the dialog item. The notification procedure gets called for
TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_CONTAINER
the cell.
9.2.3 Predefined Attributes GUID-FE65FAFE-AF40-4217-AA7A-266D7A4E4833 v1
_ABANDON_ITEM
Specifies which dialog item that is the abandon item. The NOTIFY action method of the abandon
item is executed when the user presses the abandon key. The meaning of the abandon key depends
on current look-and-feel. On Microsoft Windows, the abandon key is Escape (ESC).
Description: A reference to a dialog item such as VS_TEXT,

VS_BUTTON etc. The reference is a text reference to
the name of the object.
Data type: Dialog Item
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_BOUNDS_GEOMETRY
The BOUNDS_GEOMETRY is the entire virtual coordinate space of the container. Position (0,0) in
the container coordinate system is at the lower left corner of the BOUNDS_GEOMETRY. The
BOUNDS_GEOMETRY is interpreted in the same coordinate space as the GEOMETRY of the
object. Each object in the container is placed relative to the lower left corner of the
BOUNDS_GEOMETRY.

Visual SCIL Objects
VS_CONTAINER
Description: A list containing the attributes X, Y, W, H. The attributes

describe coordinates within the Visual SCIL coordinate
system.
Data type: List
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Example:
_CONFIRM_ITEM
Specifies which dialog item is the confirm item. The NOTIFY action method of the confirm item is
executed when the user presses the confirm key. The meaning of the confirm key depends on
current look-and-feel. On Microsoft Windows, the confirm key is Return (ENTER). The confirm item is
usually visually indicated with a thicker border than other items.

_CONTENT_GEOMETRY
The CONTENT_GEOMETRY is the portion of the coordinate space that is visible to the user at any
given moment. If CONTENT_GEOMETRY is smaller than BOUNDS_GEOMETRY, scroll bars must
be inserted for horizontal and vertical scrolling. The BOUNDS_GEOMETRY is clipped to
CONTENT_GEOMETRY when the interior of the container is drawn.

system.
Data type: List
Access: Read-only

Visual SCIL Objects
VS_CONTAINER
_DEFAULT_FOCUS_ITEM
Specified which dialog item should receive keyboard focus when the container receives keyboard
focus.

Example:
.SET MY_CONTAINER._DEFAULT_FOCUS_ITEM = “MY_LIST“
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FLAT_KEYBOARD_TRAVERSAL_ENABLED
Specifies that the container does not interfere with the traversal of the objects in the dialog (for
example when using the TAB key to move from object to object). When
_FLAT_KEYBOARD_TRAVERSAL_ENABLED is TRUE, the objects appear to be on the same level
although they are within a container. The appearance of the container is also different depending on
this attribute.

Data type: Boolean
Example:
.SET MY_CONTAINER._FLAT_KEYBOARD_TRAVERSAL_ENABLED = TRUE
_FOCUS_ITEM
Changes the current keyboard focus of the dialog or container to the specified dialog item. The dialog
item that has keyboard focus receives all normal keystrokes and certain function keys. If the object is
open, the appearance may change to indicate which item has focus. For some look-and-feels, the

Visual SCIL Objects
VS_CONTAINER
dashed line is drawn around the objects label. Note that the current focus item is set to the
_FOCUS_ITEM when the dialog/container is opened, so any changes to a closed dialog/container
may be lost when the dialog/container is opened.

Example:
.SET MY_CONTAINER._FOCUS_ITEM = “MY_OK_BUTTON“
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:

Visual SCIL Objects
VS_CONTAINER
_GEOMETRY
Example:
_HAS_BORDER
Determines whether the dialog item should be drawn with a border or not. The exact interpretation of

Data type: Boolean
Default value: TRUE
Example:
_HORIZONTAL_SCROLL_BAR_ENABLED
Specifies whether the container has a horizontal scroll bar.

Data type: Boolean
Example:
.SET MY_CONTAINER._HORIZONTAL_SCROLL_BAR_ENABLED = TRUE
_IMAGE

Example:
_ITEM_COUNT
Specifies the number of dialog items in the object. This attribute specifies the number of dialog items
added directly to the object. Since certain dialog items may contain others (for example containers),
the total number of dialog items in the object may be larger.

Visual SCIL Objects
VS_CONTAINER

Data type: Integer
Default value: 0
Access: Read-only
Example:
@NUMBER_OF_DIALOG_ITEMS = MY_CONTAINER._ITEM_COUNT
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
Specifies a pop-up menu that is associated with the object. This menu is activated byu right-clicking
the object.

Example:
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TITLE

Data type: Text
Example:
_TOOLTIP_TEXT

Visual SCIL Objects
VS_CONTAINER
Data type: Text
Example:
_VARIABLE_NAMES
_VERTICAL_SCROLL_BAR_ENABLED
Specifies whether the container has a vertical scroll bar.

Data type: Boolean
Example:
.SET MY_CONTAINER._VERTICAL_SCROLL_BAR_ENABLED = TRUE
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
9.2.4 Predefined Methods GUID-48EE1A11-4E72-4735-A1B1-12895B1DC461 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_ITEM_INDEX
Returns the item index of the dialog item inside container. The item index specifies the tabbing and
drawing order between dialog items inside a container.

Visual SCIL Objects
VS_CONTAINER

Parameter(s)
ITEM Dialog Item
A reference to a dialog item such as VS_TEXT,
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_SET_ITEM_INDEX
Specifies the item index of the dialog item inside container. The item index specifies the tabbing and
drawing order between dialog items inside a container.

Parameter(s)
ITEM Dialog Item
INDEX Integer
An integer value.

Visual SCIL Objects
86
VS_DIALOG
Section 10 VS_DIALOG GUID-364FBC5E-48C7-42A8-B968-9D4328FB8051 v1
10.1 Overview GUID-9108DE7C-5D90-48F4-8D79-4634AD7B326B v1
A VS_DIALOG is a top-level window that can contain dialog items. Dialogs can be created
dynamically or by using the dialog editor. Dialog items are rectangular sub-regions of the dialog.
Dialog items implement individual user interface objects, such as buttons, lists and other objects. The
NOTIFY callback of the VS_DIALOG is run whenever a dialog is moved or resized.
10.1.1 Action Attributes GUID-6BA880E4-8CFA-4565-BB2B-C64971A62053 v1
Name Type
"_ARRANGE_NOTIFY" Text vector
"_CLOSE_NOTIFY" Text vector
"_GOT_FOCUS_NOTIFY" Text vector
"_KEY_PRESSED" Text vector
"_LOST_FOCUS_NOTIFY" Text vector
10.1.2 Action Methods GUID-6AD0A82F-CCF8-4FB2-A756-4D621703F508 v1
Name Type
"ARRANGE_NOTIFY" No return value
"CLOSE_NOTIFY" Boolean
"GOT_FOCUS_NOTIFY" No return value
"KEY_PRESSED" Boolean
"LOST_FOCUS_NOTIFY" No return value
10.1.3 Predefined Attributes GUID-335A0EC1-0020-49C4-BC1D-855739FA0664 v1
Name Type
"_BUSY" Boolean
"_FONT" Font

Visual SCIL Objects
VS_DIALOG
"_GEOMETRY" List
"_ICON" Image reference
"_ICONIFIED" Boolean
"_LEADER_DIALOG" Dialog reference
"_LEADER_DIALOG_ITEM" Dialog item
"_MAXIMIZED" Boolean
"_MODAL" Boolean
"_OBJECT_NAME" Text
"_OPEN" Boolean
"_STYLE" Vector
"_TITLE" Text
10.1.4 Predefined Methods GUID-3D760515-A0E1-4886-820F-E7E8B6C4041B v1
Name Type
"_GET_POINTER_POS" No return value
"_PLACE" No return value
"_PLACE_ACCORDING_TO_DIALOG_ITEM_GEOMETRY" No return value
"_PLACE_ACCORDING_TO_GEOMETRY" No return value
"_PLACE_ACCORDING_TO_SCIL_GEOMETRY" No return value
"_PRINT" No return value
"_RAISE" No return value

Visual SCIL Objects
VS_DIALOG
10.2 Details GUID-C553440B-C8F5-4618-838B-AFDFBA9CE423 v1
10.2.1 Action Attributes GUID-5FE030A9-B8B3-4FF5-B996-2B8B87BBA673 v1
_ARRANGE_NOTIFY
Setting this attribute specifies the action method ARRANGE_NOTIFY.
_CLOSE_NOTIFY
Setting this attribute specifies the action method CLOSE_NOTIFY.
Example:
.SET MY_DIALOG._CLOSE_NOTIFY = (“ROOT.CLOSE_DIALOG“, ““)
_GOT_FOCUS_NOTIFY
Setting this attribute specifies the action method GOT_FOCUS_NOTIFY.
_KEY_PRESSED
Setting this attribute specifies the action method KEY_PRESSED
_LOST_FOCUS_NOTIFY
Setting this attribute specifies the action method LOST_FOCUS_NOTIFY.
_NOTIFY
10.2.2 Action Methods GUID-F141BC65-285A-464B-B741-EC148041242C v1
ARRANGE_NOTIFY
This action method is executed when the size of the dialog is changed with the mouse and button is
released.
CLOSE_NOTIFY
The CLOSE_NOTIFY action method is called immediately after the user chose to close a dialog. It is
called before the dialog is actually closed. If the method returns TRUE, the dialog is not closed. If it
returns FALSE, the dialog is closed normally. Note that the CLOSE_NOTIFY action method is not
always run. For example, it is not run when a dialog is deleted or closed by the program. Normal
cleaning up after a dialog should be done in the DELETE method of the dialog and not in the
CLOSE_NOTIFY method.

Visual SCIL Objects
VS_DIALOG
Data type to be returned: Boolean
GOT_FOCUS_NOTIFY
This action method is executed immediately after the dialog has got input focus.
KEY_PRESSED
This action method is executed after a key or key combination is pressed in the dialog which has
keyboard input focus. Four arguments are passed to the method: Key (text representation of the
key), Alt_Enabled (boolean), Ctrl_Enabled (boolean), Shift_Enabled (boolean).
The following key combinations are system reserved and do not activate the action
method: CTRL+ALT+DEL, ALT+TAB, ALT+ENTER, ALT+ESC, CTRL+ESC.
LOST_FOCUS_NOTIFY
This action method is executed immediately after the dialog has lost input focus.
NOTIFY
Specifies the notification procedure of the object. The notification procedure gets called for different
reasons with different objects. See the general object description for a description of NOTIFY for a
specific object.
10.2.3 Predefined Attributes GUID-593A17B7-FC10-4607-B3DE-4208EF5CB7C8 v1
_ABANDON_ITEM
Specifies which dialog item is the abandon item. The NOTIFY action method of the abandon item is
executed when the user presses the abandon key. The meaning of the abandon key depends on
current look-and-feel. On Microsoft Windows, the abandon key is Escape (ESC).

Example:
.SET MY_DIALOG._ABANDON_ITEM = “MY_CANCEL_BUTTON“
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR

Visual SCIL Objects
VS_DIALOG
_BUSY
Setting the _BUSY attribute to TRUE changes the appearance of the window to indicate that the
window is unavailable to the user. On Windows platform, the cursor is displayed as an hour glass.
This function is normally used to indicate that a long operation is about to occur. This attribute is
automatically set to FALSE when the long operation is finished.

Data type: Boolean
_CHILD_OBJECTS
_CONFIRM_ITEM

Example:
.SET MY_DIALOG._CONFIRM_ITEM = “MY_OK_BUTTON“
_DEFAULT_FOCUS_ITEM
Specifies which dialog item should receive keyboard focus when the dialog receives keyboard focus.

Example:
.SET MY_DIALOG._DEFAULT_FOCUS_ITEM = “MY_TEXT“
_FILE_REVISION

Visual SCIL Objects
VS_DIALOG
_FOCUS_ITEM
Specifies the dialog item that currently has keyboard focus.

Example:
.SET MY_DIALOG._FOCUS_ITEM = “MY_TEXT“
_FOCUSABLE
Designates whether the window should receive keyboard focus or not. Keyboard focus policy is
dependent on the window system. This function only indicates that the window has use for key
events. The window manager lets the user manipulate rectangular, overlapping display regions
known as windows. Window manager windows correspond to the top-level windows of the underlying
window system (X Window System and Microsoft Windows, for example).

Data type: Boolean
Default value: TRUE
_FONT
_FOREGROUND_COLOR
_GEOMETRY
_ICON
Specifies the icon used in the title of the window or when the window is iconified. Note that the
_ICON attribute must be set from at least one object hierarchy level upper than the window itself,
otherwise the delete method of the window is not allowed. The text assigned into attribute contains
the image reference.

Example:
.SET MY_DIALOG._ICON = “ROOT\ IMAGE1“

Visual SCIL Objects
VS_DIALOG
_ICONIFIED
Designates whether the window is iconified or not. The exact implication of iconification depends on
the window system and window manager in use. The window manager lets the user manipulate
rectangular, overlapping display regions known as windows. Window manager windows correspond
to the top-level windows of the underlying window system (X Window System and Microsoft
Windows, for example).

Data type: Boolean
_ITEM_COUNT
Specifies the number of dialog items in the dialog. This attribute specifies the number of dialog items
added directly to the dialog. Since certain dialog items may contain others (for example containers),
the total number of dialog items in the dialog may be larger.

Data type: Integer
Default value: 0
Access: Read-only
Example:
@NUMBER_OF_DIALOG_ITEMS = MY_DIALOG._ITEM_COUNT
_LEADER_DIALOG
Defines a leader-follower relationship between dialogs. When a dialog's leader is opened, closed,
iconified, uniconified, blocked, or unblocked, any follower dialog receive the same message as a
side-effect. The exact implications of this designation are window system dependent. Typically,
dialogs with the same leader are placed in a group by the window system. If either dialog is
destroyed, the other dialogs' reference to it is deleted automatically. The _LEADER_DIALOG
attribute of a dialog must be set before the dialog is opened.
Dialogs also inherit attributes from their leaders if the attributes are not specified in the dialog itself or
its class.
Description: A reference to a dialog object.

Data type: Dialog reference
Access: Write-only
_LEADER_DIALOG_ITEM
Like _LEADER_DIALOG attribute _LEADER_DIALOG_ITEM attribute defines a leader dialog for the
given window. The leader dialog holds the item specified. For more information about leader-follower
dialog relationship, see description of the _LEADER_DIALOG attribute. Setting this attribute to empty
text unsets the leader dialog for the given window.
This attribute can be used, for example, in a picture method, setting picture container as the leader
dialog item. This is the only way to raise a new dialog from a picture context and set the picture

Visual SCIL Objects
VS_DIALOG
holding dialog as leader because the holding dialog is not accessible directly from the picture
context.
Example:
; in a picture container context:
.set someDialog._LEADER_DIALOG_ITEM = “ROOT”
; ROOT is the picture container
_MAX_HEIGHT
_MAX_WIDTH
_MAXIMIZED
Setting the _MAXIMIZED attribute to TRUE changes the size of the window so that it encloses its
maximum size or the display, whichever is smaller. The window' s current position and size are saved
for later restoration by setting the attribute to FALSE.

Data type: Boolean
_MIN_HEIGHT
_MIN_WIDTH
_MODAL
Designates whether or not the window should grab pointer and key input from other windows when it
is opened. The effect when the _MODAL attribute is TRUE is that it is impossible to activate another
window as long as the MODAL window is open.

Data type: Boolean
_OBJECT_CLASS
_OBJECT_NAME

Visual SCIL Objects
VS_DIALOG
_OPEN
Setting the _OPEN attribute to TRUE opens the window so that it is visible at its current position and
size on the display. Setting the attribute to FALSE closes but does not delete the window.

Data type: Boolean
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
For more information, see Section 3
_STYLE
The style flags determine what decorations, if any, are placed around the window' s border, as well
as how the user can directly manipulate the window. Note that the visual effect of setting style flags is
platform dependent, and not all platforms can distinguish all combinations of style flags. The best
way to use style flags is to first obtain the original set of flags from the dialog and then append or
delete the desired flags from this set.
The STYLE_BACKGROUND and STYLE_MAIN flags has to always be set.

STYLE_BACKGROUND causes the dialog to update its background.
STYLE_BACKGROUND
This attribute sets the opacity of the window. Without the STYLE_BACKGROUND attribute, the
window will contain the border along with header information, and the Iconfiable, Maximize &
Unclosable icons.
The attribute can be set as follows:
set._style = vector("STYLE_BACKGROUND")
STYLE_DOCUMENT
This attribute has no effect on the windows platform.
The visual effect of setting style flags is platform dependent, and not all platforms can distinguish all
combinations of style flags.

Visual SCIL Objects
VS_DIALOG
Description: Any combination of the following style flags given as a

vector containing text strings. The flags are:
STYLE_BACKGROUND - An opaque background
STYLE_BORDER - A border around the content area
STYLE_MOVABLE - A title bar or other draggable area
STYLE_RESIZABLE - Resize handles or a grow box
STYLE_ICONIFIABLE - An iconify/minimize box
STYLE_MAXIMIZABLE - A maximize/zoom box
STYLE_MAIN - The top-level, non-document window
STYLE_DOCUMENT - Window contains a document
STYLE_CONFIRM - Window is a confirmation dialog
STYLE_UNCLOSABLE - No close box
STYLE_PALETTE - Window is a Tool window
Data type: Vector
Default value: ("STYLE_BACKGROUND", "STYLE_BORDER",
"STYLE_ICONIFIABLE", "STYLE_MAIN",
"STYLE_MAXIMIZABLE", "STYLE_MOVABLE",
"STYLE_RESIZABLE")
_TITLE
The title of the window. Note that the title may not be visible under certain circumstances, for
example, if the window or dialog does not have a title bar.

Data type: Text
_VARIABLE_NAMES
10.2.4 Predefined Methods GUID-C38E82CA-9B67-4AF7-87F6-E2F343DA0ABD v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_ITEM_INDEX
Returns the item index of the dialog item inside dialog. The item index specifies the tabbing and
drawing order between dialog items inside dialog.

Parameter(s)
ITEM Dialog Item

Visual SCIL Objects
VS_DIALOG
_GET_POINTER_POS
Returns a list containing the attribute names X and Y. X and Y are integers referring to the current
pointer position. The coordinates are given relative to the coordinate system of the object that is
executing the method call.
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_PLACE
Positions a dialogs relative place compared to another dialog. The BASE parameter specifies the
dialog to be used as base for the positioning. The parameters X_FLAGS and Y_FLAGS specify the
relation to BASE on the different coordinate axes. The following flags specify which side is used
when determining the new coordinates: PLACE_LEFT, PLACE_RIGHT, PLACE_TOP and
PLACE_BOTTOM.
The following flags indicates how to locate the side of the dialog specified above:
PLACE_NEAR = Completely outside with a small margin
PLACE_ADJACENT = Completely outside with no margin
PLACE_STRADDLE= Half inside, half outside
PLACE_ALIGN = Completely inside with no margin
PLACE_INSET= Completely inside with a small margin
PLACE_HALF = Opposite side touches centre of base dialog
PLACE_CENTER = Centered inside
The flags above should be used together in a vector so that one value specifies which side to align
and another value how to align the side. When using PLACE_CENTER the side specification can be
left out because both sides are automatically used when centring.

Visual SCIL Objects
VS_DIALOG

Parameter(s)
BASE Dialog reference
A reference to a dialog type object. A dialog can be
X_FLAGS Vector
Any combination of the following style flags given as a
PLACE_BOTTOM, PLACE_LEFT, PLACE_RIGHT,
PLACE_NEAR, PLACE_ADJACENT,
PLACE_STRADDLE, PLACE_ALIGN, PLACE_INSET,
PLACE_HALF, PLACE_CENTER and PLACE_TOP.
Y_FLAGS Vector
Example:
Example 1: Placing MY_DIALOG at TOP/LEFT of YOUR_DIALOG:

MY_DIALOG._PLACE(“YOUR_DIALOG“, (“PLACE_LEFT“, “PLACE_ALIGN“),
(“PLACE_TOP“, “PLACE_ALIGN“))
Example 2: Centering MY_DIALOG relative to YOUR_DIALOG:

MY_DIALOG._PLACE(“YOUR_DIALOG“, (“PLACE_CENTER“), (“PLACE_CENTER“))
_PLACE_ACCORDING_TO_DIALOG_ITEM_GEOMETRY
Positions dialogs relative place compared to the given rectangle in the coordinate system of a dialog
item. The BASE and RECT parameters specify the dialog item and the rectangle to be used as base
for the positioning. The parameters X_FLAGS and Y_FLAGS specify the relation to BASE on the
different coordinate axes. The following flags specify which side is used when determining the new
coordinates: PLACE_LEFT, PLACE_RIGHT, PLACE_TOP and PLACE_BOTTOM. Usually, BASE
specifies a kind of container (VS_CONTAINER,VS_NOTEBOOK_PAGE, etc.), and RECT is the
geometry of a direct child item of that container. However, it is possible to specify any dialog item as
BASE, and any rectangle as RECT.
The following flags indicate how to locate the side of the dialog specified above:
left out because both sides are automatically used when centering.

Visual SCIL Objects
VS_DIALOG

Parameter(s)
BASE Dialog Item
RECT List
A list containing the attributes X, Y, W, H. The attributes
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
Example 1: Placing MY_DIALOG at TOP/LEFT of the rectangle (0, 0, 100,

100) within YOUR_CONTAINER:MY_DIALOG._PLACE(“YOUR_CONTAINER“, LIST(X=0,
Y=0, W=100, H=100),(“PLACE_LEFT“, “PLACE_ALIGN“), (“PLACE_TOP“,
“PLACE_ALIGN“))
Example 2: Centering MY_DIALOG relative to YOUR_CONTAINER itself: @GEOM =

YOUR_CONTAINER._GEOMETRY #MODIFY GEOM:V = LIST(X = 0, Y = 0)
MY_DIALOG._PLACE(“YOUR_CONTAINER“, %GEOM, (“PLACE_CENTER“),
(“PLACE_CENTER“))
_PLACE_ACCORDING_TO_GEOMETRY
Places dialogs in relative to given SCIL rectangle. The RECT parameter specifies the coordinates to
be used as base for the positioning. The parameters X_FLAGS and Y_FLAGS specify the relation to
RECT on the different coordinate axes. The following flags specify which side is used when
determining the new coordinates: PLACE_LEFT, PLACE_RIGHT, PLACE_TOP and
PLACE_BOTTOM.
PLACE_HALF = Opposite side touches centre of given rectangle

Visual SCIL Objects
VS_DIALOG

Parameter(s)
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
Placing MY_DIALOG at TOP/LEFT of RECT:

MY_DIALOG._PLACE_ACCORDING_TO_GEOMETRY(LIST(X=200,Y=200,W=0,H=0),
(“PLACE_LEFT“, “PLACE_ALIGN“), (“PLACE_TOP“, “PLACE_ALIGN“))
_PLACE_ACCORDING_TO_SCIL_GEOMETRY
Positions dialogs relative place compared to given SCIL rectangle. The RECT parameter specifies
the coordinates to be used as base for the positioning. The parameters X_FLAGS and Y_FLAGS
specify the relation to RECT on the different coordinate axes. The following flags specify which side
is used when determining the new coordinates: PLACE_LEFT, PLACE_RIGHT, PLACE_TOP and
PLACE_BOTTOM.

Visual SCIL Objects
VS_DIALOG

Parameter(s)
RECT List
describe coordinates within the SCIL coordinate system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
Placing MY_DIALOG at TOP/LEFT of RECT:

MY_DIALOG._PLACE_ACCORDING_TO_SCIL_GEOMETRY(LIST(X=200,Y=200,W=0,H=0),
_PRINT
Prints the content of the dialog to the default printer. Note that any overlapping windows which are
located inside the dialog are printed, too.
_RAISE
This method raises the dialog to the top of all other windows.
_SET_ITEM_INDEX
Specifies the item index of the dialog item inside dialog. The item index specifies the tabbing and
drawing order between dialog items inside dialog.

Parameter(s)
ITEM Dialog Item
INDEX Integer
An integer value.
_SET_MAX_SIZE

Visual SCIL Objects
VS_DIALOG
_SET_MIN_SIZE

Visual SCIL Objects
VS_FILE_CHOOSER
Section 11 VS_FILE_CHOOSER GUID-E4722F77-193F-4EFF-96BF-7804BFFBB162 v1
11.1 Overview GUID-6AE9F55C-5D11-4097-8256-8D2520E7DDEA v1
A VS_FILE_CHOOSER is an object that lets the user search the file system for a specific file. It is
used when the user specifies which file should be opened, or in which folder the file should be
stored. When the action method APPLY_FILE is run, the path description to the selected file is
passed in as an argument. The argument is read using the SCIL function ARGUMENT.
11.1.1 Action Attributes GUID-AC34E6C6-BE20-4A3E-A6D0-1D55162AA3AF v1
Name Type
"_APPLY_FILE" Text vector
"_HELP" Text vector
11.1.2 Action Methods GUID-8680BB3F-B108-46FD-8D88-1912DE19EEE6 v1
Name Type
"APPLY_FILE" Boolean
"HELP" Boolean
11.1.3 Predefined Attributes GUID-02E2C160-0A46-434E-8F21-C8DCC1C29BF6 v1
Name Type
"_BUSY" Boolean
"_DIRECTORY" Text
"_DOCUMENT_NAME" Text
"_EXTENSION_FILTER" Text
"_FONT" Font
"_GEOMETRY" List
"_HAS_HELP" Boolean

Visual SCIL Objects
VS_FILE_CHOOSER
"_MAX_HISTORY_COUNT" Integer
"_MODAL" Boolean
"_OBJECT_NAME" Text
"_OPEN" Boolean
"_OPTIONS" Vector
"_PROMPT_TEXT" Text
"_STYLE" Vector
"_TITLE" Text
"_TYPE" Text
11.1.4 Predefined Methods GUID-6656B598-A502-47C9-9721-889BBCE81583 v1
Name Type
"_ADD_FILTER_BY_REG_EXP" No return value
"_SET_ACTIVE_FILTER" No return value
11.2 Details GUID-B2D1C532-A326-4FAB-9624-1DD36E99F8A7 v1
11.2.1 Action Attributes GUID-175CD52B-9AC1-4A6A-B35C-ADBAB29795ED v1
_APPLY_FILE
Setting this attribute specifies the action method APPLY_FILE.

Visual SCIL Objects
VS_FILE_CHOOSER
Example:
.SET MY_FILE_CHOOSER._APPLY_FILE = (“ROOT.SAVEFILE(ARGUMENT(1))“,“...
_CLOSE_NOTIFY
Example:
_HELP
Setting this attribute specifies the action method HELP.
Example:
.SET MY_DIALOG._HELP = (“ROOT.HELP_DIALOG“, ““
_NOTIFY
11.2.2 Action Methods GUID-99625C0A-5939-4413-B878-40E48485F668 v1
APPLY_FILE
This action method is executed when the user has chosen a file and pressed the OK or Apply
button. The action method gets one input parameter that is the path, and a file that has been chosen
in the file chooser. This action method should return TRUE if the file or directory is acceptable, in
which case the file chooser is closed, or FALSE if the file or directory is not aceptable, in which case
the file chooser is not closed.
CLOSE_NOTIFY
The CLOSE_NOTIFY action method is called immediately after the user has chosen to close the
dialog. It is called before the dialog is actually closed. If the method returns TRUE, the dialog is not
closed. If it returns FALSE, the dialog is closed normally. Note that the CLOSE_NOTIFY action
method is not always run. For example, it is not run when a dialog is deleted or closed by the
program. Normal cleaning up after a dialog should be done in the DELETE method of the dialog and
not in the CLOSE_NOTIFY method.
HELP
Specifies the action method that is executed when the Help button is pressed in the confirmation
dialog.

Visual SCIL Objects
VS_FILE_CHOOSER
NOTIFY
specific object.
11.2.3 Predefined Attributes GUID-96DC639A-7D32-40F6-9E1A-75A58893119A v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
_BUSY

Data type: Boolean
_CHILD_OBJECTS
_DIRECTORY
Specifies the folder used when opening the file chooser.
Description: A text string representing the physical path.

Data type: Text
Access: Write-only
_DOCUMENT_NAME
Specifies the default file name when opening the file chooser.

Data type: Text
Access: Write-only
_EXTENSION_FILTER
Specifies an extension filter for the file chooser. The value of the attribute should be a three letter text
specifying the filename extension.

Visual SCIL Objects
VS_FILE_CHOOSER

Data type: Text
Example:
.SET MY_FILE_CHOOSER._EXTENSION_FILTER = “TXT“
_FILE_REVISION
_FONT
_FOREGROUND_COLOR
_GEOMETRY
_HAS_HELP
Specifies whether the confirmation dialog has a Help button or not.

Data type: Boolean
Example:
.SET MY_DIALOG._HAS_HELP = TRUE
_ICON

Example:

Visual SCIL Objects
VS_FILE_CHOOSER
_ICONIFIED

Data type: Boolean
_LEADER_DIALOG
iconified, uniconified, blocked, or unblocked, any follower dialogs receive the same message as a
destroyed, the other dialog's reference to it is automatically deleted. The _LEADER_DIALOG
Dialogs also inherit attributes from their leaders, if the attributes are not specified in the dialog itself
or its class. For example, _ICON, _FOREGROUND_COLOR, _BACKGROUND_COLOR and
_FONT are inherited.

Access: Write-only
_LEADER_DIALOG_ITEM
Like _LEADER_DIALOG attribute, the _LEADER_DIALOG_ITEM attribute defines a leader dialog for
the given window. The leader dialog is the one that holds the item specified. For more information
about leader-follower dialogs relationship, see the description of the _LEADER_DIALOG attribute
above. Setting this attribute to empty text unsets the leader dialog for the given window.
This attribute can be used, for example, in a picture methods, setting picture container as the leader
dialog item. This is only way to raise a new dialog from a picture context and set the picture holding
dialog as leader, because the holding dialog is not accessible directly from the picture context.
Example:
_MAX_HEIGHT

Visual SCIL Objects
VS_FILE_CHOOSER
_MAX_HISTORY_COUNT
Specifies how many values are stored in the history list of the file chooser. Note that this attribute
may be irrelevant if using default file choosers on some specific platform.

Data type: Integer
Default value: 5
_MAX_WIDTH
_MAXIMIZED

Data type: Boolean
_MIN_HEIGHT
_MIN_WIDTH
_MODAL
Designates whether or not the window should grab cursor and key input from other windows when it
is opened. When the _MODAL attribute is TRUE, it is impossible to activate another window as long
as the MODAL window is open.

Data type: Boolean
_OBJECT_CLASS
_OBJECT_NAME
_OPEN

Visual SCIL Objects
VS_FILE_CHOOSER

Data type: Boolean
_OPTIONS
Sets option flags that specifies how the file chooser should behave. The visual effect setting a
particular option is dependent on whether the operating system supports the option. The options are:
SHOW_READONLY=Show the "Read Only" toggle
DEFAULT_READONLY=This option is not in use
CONFIRM_OVERWRITE=Confirm file over writes
FILE_MUST_EXIST=Chosen item must already exist
PATH_MUST_EXIST=The path leading to the item must exist
HIDE_HIDDEN=Hide hidden items
ONLY_DIRS=Want to select a directory
MULTIPLE_ABANDON=If multiple selection, abandon apply calls if any one fails
HIDE_PATH_ENTRY=This option is not in use
READONLY=This option is not in use
OVERWRITE=This option is not in use
DIR=This option is not in use

SHOW_READONLY, CONFIRM_OVERWRITE,
FILE_MUST_EXIST, PATH_MUST_EXIST,
HIDE_HIDDEN, ONLY_DIRS, MULTIPLE_ABANDON,
DEFAULT_READONLY, HIDE_PATH_ENTRY,
READONLY, OVERWRITE and DIR.
Data type: Vector
_PROMPT_TEXT
Specifies the prompt text used in file chooser.

Data type: Text
Default value: Language dependent
Access: Write-only
_SCIL_GEOMETRY

Visual SCIL Objects
VS_FILE_CHOOSER
_SOURCE_FILE_NAME
_STYLE
The style flags determine what decorations, if any, are placed around the window's border, as well as
how the user can directly manipulate the window. Note that the visual effect of setting style flags is
platform dependent and not all platforms can distinguish all combinations of style flags. The best way
to use style flags is to first obtain the original set of flags from the dialog and then append or delete
the desired flags from this set.
The STYLE_BACKGROUND and STYLE_MAIN flags has to be set always.
STYLE_BACKGROUND
Unclosable icons.
The attribute can be set as follows
STYLE_DOCUMENT

Data type: Vector
"STYLE_RESIZABLE")
_TITLE
The title of the window. Note that the title may not be visible under certain circumstances, for
example, if the window or dialog does not have a title bar.

Visual SCIL Objects
VS_FILE_CHOOSER

Data type: Text
_TYPE
Sets the type for the file chooser. The type determines the behavior and some default texts of the file
chooser. A value of “PUT“ means that the user wants to save (or put) a file somewhere, and a value
of “GET“ means that the user wants to open (or get) a file. Note that the _TYPE attribute has to be
set before any other attribute, otherwise attributes set before _TYPE can be overwritten when _TYPE
is changed. Such attributes are for example _TITLE and _PROMPT_NAME.

GET and PUT.
Data type: Text
Default value: "GET"
Access: Write-only
_VARIABLE_NAMES
11.2.4 Predefined Methods GUID-2F3FDD9E-34F8-4B71-98BC-F523424C351D v1
_ADD_FILTER_BY_REG_EXP
Adds an advanced filtering function to the file chooser. The filter is built using regular expressions.
Note that regular expression filtering is not supported by all kinds of file choosers. The most useful
filtering function is often filename extension filtering, which is available on all kinds of file choosers
through the attribute _EXTENSION_FILTER.
Parameter(s)
FILTER_ID Text
A text string containing up to 255 characters.
TITLE Text
PATTERN Text
MAKE_DEFAULT Boolean
A value of TRUE or FALSE.
Example:
The regular expression to show only files that start with uppercase
“A“ and have the extension “VSO“ files would be :

Visual SCIL Objects
VS_FILE_CHOOSER
“^A.+\ .[vV][sS][oO]$“ This filter will show all files that start with
uppercase “A“ and have theextension VSO regardless of upper or lower case
letters in the extension.
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_POINTER_POS
cursor position. The coordinates are given relative to the coordinate system of the object that is
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_PLACE
PLACE_BOTTOM.

Visual SCIL Objects
VS_FILE_CHOOSER

Parameter(s)
X_FLAGS Vector
Y_FLAGS Vector
Example:

(“PLACE_TOP“,
“PLACE_ALIGN“))
Positions a dialogs relative place compared to the given rectangle in the coordinate system of a
dialog item. The BASE and RECT parameters specify the dialog item and the rectangle to be used
as base for the positioning. The parameters X_FLAGS and Y_FLAGS specify the relation to BASE
on the different coordinate axes. The following flags specify which side is used when determining the
new coordinates: PLACE_LEFT, PLACE_RIGHT, PLACE_TOP and PLACE_BOTTOM. Usually,
BASE specifies a kind of container (VS_CONTAINER, VS_NOTEBOOK_PAGE, etc.), and RECT is
the geometry of a direct child item of that container. However, it is possible to specify any dialog item
as BASE, and any rectangle as RECT.

Visual SCIL Objects
VS_FILE_CHOOSER
and another value how to align the side. When using PLACE_CENTER, the side specification can be

Parameter(s)
BASE Dialog Item
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:

100) within YOUR_CONTAINER:
MY_DIALOG._PLACE(“YOUR_CONTAINER“, LIST(X=0, Y=0, W=100, H=100),
Example 2: Centering MY_DIALOG relative to YOUR_CONTAINER itself:
@GEOM = YOUR_CONTAINER._GEOMETRY
#MODIFY GEOM:V = LIST(X = 0, Y = 0)

Positions a dialogs relative place compared to given rectangle. The RECT parameter specifies the
coordinates to be used as base for the positioning. The parameters X_FLAGS and Y_FLAGS specify
the relation to RECT on the different coordinate axes. The following flags specify which side is used
PLACE_BOTTOM.

Visual SCIL Objects
VS_FILE_CHOOSER

Parameter(s)
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
1: Placing MY_DIALOG at TOP/LEFT of RECT:
Positions a dialogs relative place compared to given SCIL rectangle. The RECT parameter specifies
PLACE_BOTTOM.

Visual SCIL Objects
VS_FILE_CHOOSER

Parameter(s)
RECT List
X_FLAGS Vector
Y_FLAGS Vector
Example:
_RAISE
_SET_ACTIVE_FILTER
Specifies the active filter used in file chooser. Passed argument is the filter id specified by the
_ADD_FILTER_BY_REG_EXP method.

Parameter(s)
FILTER_ID Text
A text string containing up to 255 characters.
_SET_MAX_SIZE
_SET_MIN_SIZE

Visual SCIL Objects
118
VS_GRAPH
Section 12 VS_GRAPH GUID-0BF344A7-5D87-4178-ABD2-7805FE65C975 v1
12.1 Overview GUID-EB3351E9-D8FB-4B42-B537-CC4F0CEE6E32 v1
The VS_GRAPH is an object that through a simple SCIL interface is capable of visually displaying
numerical data. The data that is displayed in the graph is called datasets. A graph can display
several datasets using the same or different graph types. The individual value in the dataset is called
a point.
12.1.1 Action Attributes GUID-235282C3-A2CB-4A80-99C0-330293C9BAC4 v1
Name Type
"_AREA_SELECTED" Text vector
"_HAIRLINE_MOVED" Text vector
12.1.2 Action Methods GUID-40838CB8-C806-4763-82BE-9F15F76F0B07 v1
Name Type
"AREA_SELECTED" No return value
"HAIRLINE_MOVED" No return value
"TOOLTIP_IS_SHOWN TOOLTIP_IS_SHOWN" No return value
12.1.3 Predefined Attributes GUID-0B30EDE8-0182-4F54-9868-B25E2F82F635 v1
Name Type
"_AREA_SELECT_ENABLED" Boolean
"_DATA_SET_COUNT" Integer
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_OBJECT_NAME" Text
"_ORIENTATION_INVERTED" Boolean

Visual SCIL Objects
VS_GRAPH
"_VISIBLE" Boolean
12.1.4 Predefined Methods GUID-EB5AC556-6453-4977-8C14-E7F427E4D162 v1
Name Type
"_ADD_DATA_SET" No return value
"_ADD_HAIRLINE" No return value
"_ADD_LIMIT_VALUE" No return value
"_ADD_X_AXIS" No return value
"_ADD_Y_AXIS" No return value
"_GET_DATA_SET_VALUES" List
"_GET_HAIRLINE_INTERSECTION_POINT" List
"_SET_DATA_SET_PROPERTIES" No return value
"_SET_DATA_SET_VALUES" No return value
"_SET_HAIRLINE_PROPERTIES" No return value
"_SET_X_AXIS_PROPERTIES" No return value
"_SET_Y_AXIS_PROPERTIES" No return value
"_ZOOM" No return value
12.2 Details GUID-16C15A83-9D76-4926-89C7-729C3AEEC049 v1
12.2.1 Action Attributes GUID-BE29A1BD-F6D6-4643-85A2-B779A3A807B3 v1
_AREA_SELECTED
Setting this attribute specifies the action method AREA_SELECTED.
_HAIRLINE_MOVED
Setting this attribute specifies the action method HAIRLINE_MOVED.
_TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_GRAPH
12.2.2 Action Methods GUID-5FDB41EC-71BB-4ED4-AE40-EBC9AFE1AE8F v1
AREA_SELECTED
This action method is executed when an area has been selected with the cursor and the
_AREA_SELECT_ENABLED attribute is TRUE. Four arguments are passed to this action method
specifying the selected range within the graph drawing area. The ranges are given as a percentage
of the entire unzoomed graph drawing area. The arguments are real values specifying
HORIZONTAL_LOW, HORIZONTAL_HIGH, VERTICAL_LOW and VERTICAL_HIGH.
HAIRLINE_MOVED
This action method is executed whenever a hairline has been moved. The id of the hairline is passed
as argument 1 to this action method.
TOOLTIP_IS_SHOWN
12.2.3 Predefined Attributes GUID-818F3106-F64D-4489-B4D2-E2B68D555B7D v1
_AREA_SELECT_ENABLED
Specifies whether the user can interactively select an area using the cursor. When an area within the
graph drawing area has been selected the action method AREA_SELECTED is executed.

Data type: Boolean
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE
Specifies whether a dialog item receives focus when it is clicked.

Visual SCIL Objects
VS_GRAPH

Data type: Boolean
Example:
_DATA_SET_COUNT
Indicates how many data sets are inserted into a graph.

Data type: Integer
Access: Read-only
_ENABLED
Specifies whether a dialog item responds to various events. A change of appearance is also often
Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE
Specifies whether a dialog item receives focus during normal keyboard traversal.

Data type: Boolean
Example:
_FOCUSED
Contains the value TRUE if a dialog item has the keyboard focus.

Visual SCIL Objects
VS_GRAPH

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_OBJECT_CLASS
_OBJECT_NAME
_ORIENTATION_INVERTED
Specifies wheter the sense of the X-axis and Y-axis are inverted.

Data type: Boolean
_POP_UP_MENU
the object.

Visual SCIL Objects
VS_GRAPH

Example:
.SET ROOT\ MY_LIST._POP_UP_MENU = “ROOT\ MENU1“
_TOOLTIP_TEXT
Specifies a tooltip text that appears over the object when the cursor is held over it.
Data type: Text
Example:
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_VARIABLE_NAMES
_VISIBLE
Specifies whether a dialog item is visible or not. Setting this attribute to FALSE may be useful if the

Data type: Boolean
Default value: TRUE
Example:
12.2.4 Predefined Methods GUID-6A06EAE6-AA55-4D70-9DD0-09BC1A2814C6 v1
_ADD_DATA_SET
Adds a data set to the graph. Both X-axis and Y-axis have to be added before the data set because
the data set has to be bound to the axis.

Visual SCIL Objects
VS_GRAPH

Parameter(s)
ID Integer
An integer value.
X_AXIS_ID Integer
An integer value.
Y_AXIS_ID Integer
An integer value.
_ADD_HAIRLINE
Adds a hairline to the graph. A hairline can be used to visually track or analyse the Y-value of a
dataset.

Parameter(s)
ID Integer
An integer value.
_ADD_LIMIT_VALUE
Adds a line specifying some kind of limit value to the graph. The line only has a visual appearance
and no other functionality.

Parameter(s)
ID Integer
An integer value.
AXIS_ID Integer
An integer value.
Y_VALUE Real
A real value.
LINE_COLOR Color
A color as referenced within SCIL.
LINE_STYLE Text
A text string containing one of the following keywords:
SOLID, ONOFFDASH or DOUBLEDASH.
LINE_WIDTH Integer
An integer value.
_ADD_X_AXIS
Adds an X-axis to the graph.

Parameter(s)
ID Integer
An integer value.
TYPE Text
INTEGER, REAL, DISCRETE or TIME.

Visual SCIL Objects
VS_GRAPH
PLACEMENT Text
TOP, BOTTOM, LEFT , RIGHT or
RELATED_TO_OTHER.
RELATED_TO Integer
An integer value.
Y_POSITION SCIL Value
A SCIL value of the type INTEGER, REAL or TIME.
_ADD_Y_AXIS
Adds an Y-axis to the graph.

Parameter(s)
ID Integer
An integer value.
TYPE Text
INTEGER, REAL, DISCRETE or TIME.
PLACEMENT Text
TOP, BOTTOM, LEFT , RIGHT or
RELATED_TO_OTHER.
RELATED_TO Integer
An integer value.
X_POSITION SCIL Value
A SCIL value of the type INTEGER, REAL or TIME.
_FLAG_FOR_EXECUTION
_GET_DATA_SET_VALUES
Reads the values of a specific data set from the VS_GRAPH. The values are returned as a list
containing the attributes X_VALUES and Y_VALUES which are vectors containing the values. The
types of the vector elements are dependent of respecive axis type.
Return value data type: List

Parameter(s)
ID Integer
An integer value.
_GET_HAIRLINE_INTERSECTION_POINT
Returns the cursor to where the specified hairline intersects with the specified data set. The Y-value
is interpolated if SNAP_TO_CLOSEST is FALSE. The `snap_to_closestxd5 feature works only if the
hairline is within the bounds of the data set. If the hairline is outside the bounds of the data set, the
values returned are of data type NONE.

Visual SCIL Objects
VS_GRAPH

Parameter(s)
ID Integer
An integer value.
DATASET Integer
An integer value.
SNAP_TO_CLOSEST Boolean
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_SET_DATA_SET_PROPERTIES
Sets the properties of the specified data set. Default value handling is not yet implemented, and
therefore all properties except status colors have to be given. The properties are given as a list and
are the following:
GRAPH_TYPE=Text. PLOT, AREA, BAR, STACKED_BAR or PIE
TITLE=Text. The text used as title for the data set.
LINE_STYLE=Text. Specifies the line style of the dataset, SOLID, ONOFFDASH or DOUBLEDASH.
LINE_WIDTH=Integer. Specifies the line width of the dataset.
DEFAULT_COLOR=Color. The color that is used for the data display if status coloring is not used.
SHOW_LINE=Boolean. Specifies whether the line in a line graph is visible or not.
MARKER_SHAPE=Text. DOT, BOX, TRIANGLE or DIAMOND.
SHOW_MARKER=Boolean. Specifies whether the data point marker is visible or not.
SHOW_MARKER=Boolean. Specifies whether the data point marker is visible or not.
MARKER_COLOR=Color. he color that is used for the marker display if show_markerxd5 is true and
‘graph_typexd5 is PLOT.
STATUS_0_COLOR=Color. The color that is used for the data display for the specified status of the
value.
value.

Visual SCIL Objects
VS_GRAPH
...
value.

Parameter(s)
ID Integer
An integer value.
PROPERTY_LIST List
A list containing the properties to be set.
_SET_DATA_SET_VALUES
Sets the values of a specific data set from the VS_GRAPH. The values are given as vectors. The
type of the vector element is dependent of respecive axis type. The last parameter, APPEND,
specifies whether the ‘x_valuesxd5 and ‘y_valuesxd5 are appended to the current data. The X values
of the appended data have to be larger than the previously existing data.

Parameter(s)
ID Integer
An integer value.
X_VALUES List
A list containing the vectors x_values and y_values.
Y_VALUES List
A list containing the vectors x_values and y_values.
APPEND Boolean
_SET_HAIRLINE_PROPERTIES
Sets the properties of the specified hairline. Default value handling is not yet implemented, and
therefore all properties have to be given. The properties are given as a list and are the following:
COLOR=Color. The color of the hairline.
ENABLED= Boolean. Specifies whether the hairline is in use or not. If this attribute is TRUE the
action method _HAIRLINE_MOVED is executed whenever the hairline is moved.
LINE_STYLE=Text. Specifies the line style of the hairline, SOLID, ONOFFDASH or DOUBLEDASH.
LINE_WIDTH=Integer. Specifies the line width of the hairline.
POSITION=Real. Specifies where the hairline is located in the graph. The position is given in
percentage (0.0-100.0).

Parameter(s)
ID Integer
An integer value.
PROPERTY_LIST List

Visual SCIL Objects
VS_GRAPH
_SET_X_AXIS_PROPERTIES
Sets the properties of the specified hairline. Default value handling is not yet implemented so all
properties have to be given. The properties are given as a list and are the following:
MIN=The minimum value that is displayed on the axis. A single SCIL value of the data type defined
by the ‘typexd5 of the axis.
MAX=The maximum value that is displayed on the axis. A single SCIL value of the data type defined
TIME_UNIT=Text. ““, “SECONDS“, “MINUTES“, “HOURS“, “DAYS“, “WEEKS“, “MONTHS“ or

“YEARS“. This parameter is ignored if the axis type is not “TIME“.
TIME_FORMAT=Text. Format string for formatting date/time output. According to the format of the
ANSI C function strftime.
ANNOTATION_INCREMENT=Real. Specifies the spacing between the annotation labels. If the axis
type is not real the value is rounded to the nearest whole integer value.
ANNOTATION_FONT=Font. The font of the annotation text.
ANNOTATION_COLOR=Color. The color of the annotation text.
TICK_INCREMENT=Real. Specifies the spacing between the tick marks. If the axis type is not real
the value is rounded to the nearest whole integer value.
AXIS_COLOR=Color. The color of the axis.
AXIS_TITLE=Text. The title of the axis.
AXIS_TITLE_FONT=Font. The font of the axis title.
AXIS_TITLE_COLOR=Color. A color as defined in SCIL.
AXIS_TITLE_PLACEMENT=LEFT or RIGHT
DISPLAY_AXIS_TITLE_ENABLED=Boolean. Specifies whether the axis title is displayed or not.
GRID_MODE=Text. NONE, ANNOTATION or TICK
GRID_LINE_WIDTH=Integer. The line width of the grid line.
GRID_COLOR=Color. Specifies the color of the grid lines.
GRID_LINE_STYLE=Text. SOLID, ONOFFDASH or DOUBLEDASH.
LINE_STYLE=Text. SOLID, ONOFFDASH or DOUBLEDASH.

Parameter(s)
ID Integer
An integer value.
PROPERTY_LIST List
_SET_Y_AXIS_PROPERTIES
Sets the properties of the specified axis. Default value handling is not yet implemented, and therefore
all properties have to be given. The properties are given as a list and are the following:

Visual SCIL Objects
VS_GRAPH
MIN=The minimum value that is displayed on the axis. A single SCIL value of the data type defined
MAX=The maximum value that is displayed on the axis. A single SCIL value of the data type defined
TIME_UNIT=Text. Empty string. Not relevant for the y-axis.
TIME_FORMAT=Text. Empty string. Not relevant for the y-axis.
ANNOTATION_INCREMENT=Real. Specifies the spacing between the annotation labels. If the axis
type is not real the value is rounded to the nearest whole integer value.
ANNOTATION_FONT=Font. The font of the annotation text.
ANNOTATION_COLOR=Color. The color of the annotation text.
TICK_INCREMENT=Real. Specifies the spacing between the tick marks. If the axis type is not real
the value is rounded to the nearest whole integer value.
AXIS_COLOR=Color. The color of the axis.
AXIS_TITLE=Text. The title of the axis.
AXIS_TITLE_FONT=Font. The font of the axis title.
AXIS_TITLE_COLOR=Color. A color as defined in SCIL.
AXIS_TITLE_PLACEMENT=TOP or BOTTOM
DISPLAY_AXIS_TITLE_ENABLED=Boolean. Specifies whether the axis title is displayed or not.
GRID_MODE=Text. NONE, ANNOTATION or TICK
GRID_LINE_WIDTH=Integer. The line width of the grid line.
GRID_COLOR=Color. Specifies the color of the grid lines.
GRID_LINE_STYLE=Text. SOLID, ONOFFDASH or DOUBLEDASH.
LINE_STYLE=Text. SOLID, ONOFFDASH or DOUBLEDASH.

Parameter(s)
ID Integer
An integer value.
PROPERTY_LIST List
_ZOOM
Zooms the graph according to given parameters. The ranges are given as a percentage (0.0-100.0)
of the total graph drawing area. When zooming a graph, the axis are also changed so that they are
on their original places in the zoomed graph if they were placed on LEFT, RIGHT, TOP or BOTTOM.
The ‘annotation_incrementxd5 and ‘tick incrementxd5 for the entire axis are automatically adjusted
so that about the same amount of annotations and ticks are visible in the zoomed graph. If an axis
type is TIME, the ‘time_unitxd5 may change if relevant.

Visual SCIL Objects
VS_GRAPH

Parameter(s)
HORIZONTAL_LOW Real
A real value.
HORIZONTAL_HIGH Real
A real value.
VERTICAL_LOW Real
A real value.
VERTICAL_HIGH Real
A real value.

Visual SCIL Objects
132
VS_GRAPH_LEGEND
Section 13 VS_GRAPH_LEGEND GUID-91DEA318-C03C-4CE4-874A-277A97B1D27A v1
13.1 Overview GUID-180EDC26-E08F-4F71-A2A3-C20A356E3A9F v1
This object is used together with the VS_GRAPH object to display the legend for a VS_GRAPH
object. A legend displays the title, line style and marker style of the different datasets in the graph.
13.1.1 Action Attributes GUID-633B8602-F31C-4EDA-8575-12555D170126 v1
Name Type
13.1.2 Action Methods GUID-B88396C8-58AA-4077-B7F6-AF3AA20F33AE v1
Name Type
13.1.3 Predefined Attributes GUID-A652CDC5-7E29-4A61-B963-190549A1597E v1
Name Type
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_GRAPH" Dialog Item
"_OBJECT_NAME" Text
"_VISIBLE" Boolean

Visual SCIL Objects
VS_GRAPH_LEGEND
13.1.4 Predefined Methods GUID-4047C284-7C1B-4874-9754-7E636857F8BE v1
Name Type
13.2 Details GUID-798848DD-F871-4290-BCE5-687AE56D8768 v1
13.2.1 Action Attributes GUID-F7B28E70-6B8B-4CBF-829D-75CAB78E9437 v1
_TOOLTIP_IS_SHOWN
13.2.2 Action Methods GUID-F38E1B4B-C061-4445-9B3E-79415DC244F5 v1
TOOLTIP_IS_SHOWN
13.2.3 Predefined Attributes GUID-FD3B5CDB-5FEE-43D3-956C-A3CBF29A548E v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean

Visual SCIL Objects
VS_GRAPH_LEGEND
Example:
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:

Visual SCIL Objects
VS_GRAPH_LEGEND
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_GRAPH
Specifies which VS_GRAPH object a legend is connected to.

_HAS_BORDER
Determines whether a dialog item should be drawn with a border or not. The exact interpretation of

Data type: Boolean
Example:
_OBJECT_CLASS
_OBJECT_NAME
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TOOLTIP_TEXT

Visual SCIL Objects
VS_GRAPH_LEGEND
Specifies the tooltip text that appears over an object when the cursor is held over the object.
Data type: Text
Example:
_VARIABLE_NAMES
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
13.2.4 Predefined Methods GUID-03C6897D-15ED-40EB-83BC-48195E6FCD3F v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH
Returns the width of a given string in the current font of the object.

Parameter(s)
STRING Text

Visual SCIL Objects
138
VS_HEADER
Section 14 VS_HEADER GUID-3A9D63D7-EC4C-49F3-84F4-EE58234A089E v1
14.1 Overview GUID-8ACC9F4D-46AF-44CD-9C26-2F94E633C558 v1
The VS_HEADER object can be used as a header for any kind of column based data. The usage of
this object is based on both the VS_HEADER and VS_HEADER_ITEM. A VS_HEADER is the main
object that can contain any number of VS_HEADER_ITEMs. The user interacts with the header
items and the programmer gets a notification of the actions through the action methods of
VS_HEADER. The VS_HEADER can be inserted in a dialog using the Dialog Editor but the
VS_HEADER_ITEM objects are inserted by the program.
Example: (the INIT method of a VS_HEADER object)
.CREATE ITEM1=VS_HEADER_ITEM(_WIDTH=50, _TITLE=“Item 1“)
14.1.1 Action Attributes GUID-DD02785B-804B-4377-98FD-40700EFA34DA v1
Name Type
"_HEADER_RESIZED" Text vector
"_ITEM_DOUBLE_CLICKED" Text vector
"_ITEM_MOVED" Text vector
"_ITEM_RESIZED" Text vector
"_ITEM_SELECTED" Text vector
14.1.2 Action Methods GUID-3759F6D3-FC16-44BE-B19C-B7B0D932495C v1
Name Type
"HEADER_RESIZED" No return value
"ITEM_DOUBLE_CLICKED" No return value
"ITEM_MOVED" No return value
"ITEM_RESIZED" No return value
"ITEM_SELECTED" No return value
14.1.3 Predefined Attributes GUID-8E0B43A5-FFBF-4D6E-BAAD-3D777DDDCAA4 v1
Name Type
"_ARRANGE_ENABLED" Boolean
"_ENABLED" Boolean

Visual SCIL Objects
VS_HEADER
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_ITEM_SPACING" Integer
"_MNEMONIC" Text
"_OBJECT_NAME" Text
"_SCROLL_OFFSET" Integer
"_TITLE" Text
"_VISIBLE" Boolean
14.1.4 Predefined Methods GUID-3D8D9C7C-B658-4365-B1AD-119A226D396D v1
Name Type
14.2 Details GUID-0D4E52B1-08A2-4A86-A893-51676CC39BFA v1
14.2.1 Action Attributes GUID-4D2AD518-908F-493F-82A6-114956BFBC3F v1
_HEADER_RESIZED
Setting this attribute specifies the action method HEADER_RESIZED.
_ITEM_DOUBLE_CLICKED
Setting this attribute specifies the action method ITEM_DOUBLE_CLICKED.
_ITEM_MOVED
Setting this attribute specifies the action method ITEM_MOVED.

Visual SCIL Objects
VS_HEADER
_ITEM_RESIZED
Setting this attribute specifies the action method ITEM_RESIZED.
_ITEM_SELECTED
Setting this attribute specifies the action method ITEM_SELECTED.
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN
14.2.2 Action Methods GUID-A0760F27-C8B9-434E-A1A0-19EC523C5BD0 v1
HEADER_RESIZED
Executed whenever the size of the whole VS_HEADER has been changed.
ITEM_DOUBLE_CLICKED
Executed whenever an item has been double-clicked by the user. The position number of the
VS_HEADER_ITEM that was double-clicked is passed as argument 1 to this action method.
ITEM_MOVED
Executed whenever the user has moved an object. Two arguments are passed to this action method,
the position FROM which the item was moved and the position TO which it was moved.
ITEM_RESIZED
Executed whenever an item has been resized by the user. Two arguments are passed to this action
method, the position of the item that was resized and the new width of the item.

Visual SCIL Objects
VS_HEADER
ITEM_SELECTED
Executed whenever an item has been selected (single-clicked) by the user. The position number of
the selected item is passed to this action method as argument 1.
TOOLTIP_IS_SHOWN
14.2.3 Predefined Attributes GUID-C50DA02D-964E-4B48-B85E-D29726F7DC8D v1
_ARRANGE_ENABLED
Specifies whether the user is allowed to change the order of the items in the header. If the user
moves an item, the action method ITEM_MOVED is executed.

Data type: Boolean
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Example:

Visual SCIL Objects
VS_HEADER
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:

Visual SCIL Objects
VS_HEADER
_GEOMETRY
Example:
_HAS_BORDER

Data type: Boolean
Example:
_HAS_IMAGE_MASK
Specifies whether the image of a dialog item is drawn as a mask for the item foreground color or not.
If this attribute is TRUE, the background of the dialog item is visible through the image. Note that not
all dialog items can contain an image.

Data type: Boolean
Example:
_IMAGE

Example:

Visual SCIL Objects
VS_HEADER
_ITEM_COUNT
Readable attribute that contains the number of items in the VS_HEADER.

Data type: Integer
Default value: 0
Access: Read-only
_ITEM_SPACING
The spacing between the items in the header.

Data type: Integer
Default value: 2
_MNEMONIC

Data type: Text
Example:
_OBJECT_CLASS
_OBJECT_NAME
_SCIL_GEOMETRY
_SCROLL_OFFSET
The amount of times the items in the header has been scrolled. This is useful for example when the
VS_HEADER has to follow another object that can be scrolled.

Data type: Integer
Default value: 0

Visual SCIL Objects
VS_HEADER
_SOURCE_FILE_NAME
_TITLE

Data type: Text
Example:
_TOOLTIP_TEXT
Specifies the tooltip text that appears over the object when the cursor is held over the object.
Data type: Text
Example:
_VARIABLE_NAMES
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
14.2.4 Predefined Methods GUID-8565EDFD-C193-40AF-964D-CBA0205D4415 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Visual SCIL Objects
VS_HEADER

Parameter(s)
STRING Text

Visual SCIL Objects
148
VS_HEADER_ITEM
Section 15 VS_HEADER_ITEM GUID-956354F5-DD7A-4D16-8825-F9CA3E9F83ED v1
15.1 Overview GUID-8AB724DB-3B03-41ED-BD2D-3DABF9821F14 v1
The VS_HEADER_ITEM object is used together with the VS_HEADER object. The usage of this
object is based on both the VS_HEADER and VS_HEADER_ITEM. A VS_HEADER is the main
object that can contain any number of VS_HEADER_ITEMs. The user interacts with the header
items and the programmer receives a notification of the actions through the action methods of
VS_HEADER. The VS_HEADER can be inserted in a dialog using the Dialog Editor but the
VS_HEADER_ITEM objects are inserted by the program.
Example: (the INIT method of a VS_HEADER object)
15.1.1 Predefined Attributes GUID-86810D36-BD2B-4CC8-8D16-C01CE3913EB8 v1
Name Type
"_OBJECT_NAME" Text
"_OFFSET" Integer
"_RESIZE_ENABLED" Boolean
"_TITLE" Text
"_WIDTH" Integer
15.2 Details GUID-F67B188A-9801-4839-B766-242CE732803F v1
15.2.1 Predefined Attributes GUID-FCC3117F-C30B-457D-B394-50DBBDA5DC7B v1
_ATTRIBUTE_NAMES
_CHILD_OBJECTS
_FILE_REVISION

Visual SCIL Objects
VS_HEADER_ITEM
_MAX_WIDTH
Specifies the maximum width of an item. The user cannot enlarge the item beyond this size.

Data type: Integer
_MIN_WIDTH
Specifies the minimum width of an item. The user cannot make the item smaller than this size.

Data type: Integer
_OBJECT_CLASS
_OBJECT_NAME
_OFFSET
A read only attribute that indicates where the left side of an item is located in relation to the
VS_HEADER.

Data type: Integer
Access: Read-only
_RESIZE_ENABLED
Specifies whether the user can resize an item or not.

Data type: Boolean
Default value: TRUE
_SOURCE_FILE_NAME
_TITLE
The visible title of the item.

Visual SCIL Objects
VS_HEADER_ITEM

Data type: Text
_VARIABLE_NAMES
_WIDTH
The current width of the item.

Data type: Integer

Visual SCIL Objects
152
VS_ICON_VIEW
Section 16 VS_ICON_VIEW GUID-43A2A2FF-82BF-456F-8456-59BAFCC14B0D v1
16.1 Overview GUID-E25E4770-034F-48EA-B316-F25D12AB704B v1
A VS_ICON_VIEW object can hold an arbitrary number of icons. The object has a predefined method
_IS_ICON_SELECTED that can be used to check the state of the icons, for example, as a response
to the DOUBLE_CLICK action method. VS_IMAGE objects can be attached to VS_ICON_VIEW.
16.1.1 Action Attributes GUID-7C75076F-F932-4122-B124-140FD0FAFD25 v1
Name Type
"_DOUBLE_CLICK" Text vector
16.1.2 Action Methods GUID-75C9652A-BF50-44D1-955D-00A92C371F9C v1
Name Type
"DOUBLE_CLICK" No return value
16.1.3 Predefined Attributes GUID-783AAB4F-C674-448D-9A78-75DE7EF934AD v1
Name Type
"_AUTO_SCROLL_ENABLED" Boolean
"_DRAG_OUTLINE" Text
"_DRAG_POLICY" Text
"_DRAG_PROHIBITED" Boolean
"_DRAG_THRESHOLD" Integer
"_ENABLED" Boolean

Visual SCIL Objects
VS_ICON_VIEW
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_GRABBING_HAND_ENABLED" Boolean
"_HORIZONTAL_SCROLL_LOCKED" Boolean
"_ICON_COUNT" Integer
"_LIVE_SELECTION_ENABLED" Boolean
"_OBJECT_NAME" Text
"_SELECT_ENCLOSED_ENABLED" Boolean
"_SINGLE_SELECTION_ENABLED" Boolean
"_SNAP_TO_GRID_ENABLED" Boolean
"_VERTICAL_SCROLL_LOCKED" Boolean
"_VIEW_BY" Text
"_VISIBLE" Boolean
16.1.4 Predefined Methods GUID-CE82B516-873C-4075-9DE7-D742C05ACB9B v1
Name Type
"_APPEND_ICON" Integer
"_ARRANGE" No return value
"_GET_ICON_NAME" Text
"_IS_ICON_SELECTED" Boolean
"_REMOVE_ICON" No return value
"_SET_ICON_IMAGE_LARGE" No return value
"_SET_ICON_IMAGE_SMALL" No return value
"_SET_ICON_NAME" No return value

Visual SCIL Objects
VS_ICON_VIEW
16.2 Details GUID-29170762-F161-4BE3-806B-CF7745C98F5A v1
16.2.1 Action Attributes GUID-18989C98-B243-4451-BC14-0DC3E5A09F08 v1
_DOUBLE_CLICK
Setting this attribute specifies the action method DOUBLE_CLICK.
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN
16.2.2 Action Methods GUID-C5181754-E64A-4B2C-B8F0-214C7155C3C6 v1
DOUBLE_CLICK
The DOUBLE_CLICK program is run whenever the user double-clicks an item in the icon view. When
a double-click occurs, the user can find out which icon was clicked with the method
_IS_ICON_SELECTED.

Visual SCIL Objects
VS_ICON_VIEW
GET_TABLE_EDIT_TEXT
This action method is executed whenever a table needs a value from an edit object. This method is
action method). This function can be used, for example, to convert an internal edit object value to text
GET_TABLE_VIEW_TEXT
This action method is executed whenever a table needs the value for the view object of the current
can be used, for example, to convert the edit object value of the cell into the text value of the cell.
NOTIFY
Specifies the notification procedure of a dialog item. The notification procedure gets called for
TOOLTIP_IS_SHOWN
This action method is executed whenever the edit object of a cell needs a value to be shown. This
value of the view object into the edit object value.
This action method is executed whenever a table needs a value for the view object. This method is
convert the text value of a cell to the current value of a view object, which is shown in the view object.
This action method has three parameters: ROW and COLUMN of the cell and the TEXT of the cell.
16.2.3 Predefined Attributes GUID-2DD1BF2D-5437-463C-97FA-1E7C8EAD8C97 v1
_ATTRIBUTE_NAMES
_AUTO_SCROLL_ENABLED
Designates whether or not the view is automatically scrolled when an object is moved outside of the
view area of the object.

Visual SCIL Objects
VS_ICON_VIEW

Data type: Boolean
Default value: TRUE
Example:
.SET MY_DOMAIN._AUTO_SCROLL_ENABLED = TRUE
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_DRAG_OUTLINE
Specifies the outlining method when dragging objects within the view.

OUTLINE_ALL, OUTLINE_TWO, OUTLINE_LIMITRECT
and OUTLINE_NONE.
OUTLINE_ALL: When the icon is dragged, the entire
icon will be outlined.
OUTLINE_TWO: When the icon is dragged, the entire
icon will be outlined by double lines.
OUTLINE_LIMITRECT: When the icon is dragged, the
entire icon will be outlined by rectangle.
OUTLINE_NONE: When the icon is dragged, the icon
will not be outlined.
_Drag_Prohibited = FALSE should be set for this to work.
Data type: Text

Default value: "OUTLINE_ALL"

Visual SCIL Objects
VS_ICON_VIEW
_DRAG_POLICY
Specifies the dragging policy to be used when dragging objects.

DRAG_NORMAL, DRAG_AUTOSCROLL and
EXTERNAL_DRAG.
DRAG_NORMAL : Normal drag without any scroll effect.
DRAG_AUTOSCROLL : While the Icon is dragged the
view gets scrolled automatically.
EXTERNAL_DRAG : Icon can be dragged to a wide
area.
_Drag_Prohibited = FALSE should be set for this to work.
Data type: Text

Default value: "DRAG_AUTOSCROLL"
_DRAG_PROHIBITED
Designates whether or not dragging is prohibited for all objects within the view.

Data type: Boolean
_DRAG_THRESHOLD
Specifies the drag threshold to be used when dragging objects within the view. The drag threshold is
the amount of movement that is required initially (in pixels) to begin dragging the object.

Data type: Integer
Default value: 0
_ENABLED

Data type: Boolean
Default value: TRUE
Example:

Visual SCIL Objects
VS_ICON_VIEW
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_GRABBING_HAND_ENABLED
Designates whether clicking and dragging the mouse in a view invokes the Grabbing hand or simply
selects objects. The Grabbing hand tracks the mouse while the mouse button is down and scrolls the
view as if the user has grabbed it, so that the scrolling of the view and the movement of the mouse
are synchronous.

Visual SCIL Objects
VS_ICON_VIEW

Data type: Boolean
_HAS_BORDER

Data type: Boolean
Default value: TRUE
Example:
Specifies whether an object has a horizontal scroll bar.

Data type: Boolean
_HORIZONTAL_SCROLL_LOCKED
Specifies whether the horizontal scrolling is locked or not.

Data type: Boolean
_ICON_COUNT
Specifies the number of icons in the icon view.

Data type: Integer
Default value: 0
Access: Read-only
_LIVE_SELECTION_ENABLED
Specifies how selected objects in the view become highlighted. When this attribute is set to TRUE,
live selection actively selects and unselects objects as tracking with the marquee occurs, rather than
selecting after the mouse button has been released.

Visual SCIL Objects
VS_ICON_VIEW

Data type: Boolean
Default value: TRUE
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
Specifies the pop-up menu that is associated with an object. This menu is activated by right-clicking
the object.

Example:
_SCIL_GEOMETRY
_SELECT_ENCLOSED_ENABLED
Specifies how objects in the view become selected. Setting this attribute to TRUE means that the
objects in the view are selected only when completely enclosed within the selection marquee. When
attribute is set to FALSE, the objects become selected if any part of the object lies within the
selection marquee.

Data type: Boolean
_SINGLE_SELECTION_ENABLED
Specifies whether single selection is used in domain view or not. When
_SINGLE_SELECTION_ENABLED attribute is set to TRUE, only one image can be selected at a
time.

Visual SCIL Objects
VS_ICON_VIEW

Data type: Boolean
_SNAP_TO_GRID_ENABLED
Specifies whether Snap to grid is used or not. Snap to grid means that objects that are moved to a
new location in the domain are aligned according to a grid.

Data type: Boolean
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Specifies a tooltip text that appears over an object when the cursor is held over the object.
Data type: Text
Example:
_VARIABLE_NAMES
Specifies whether an object has a vertical scroll bar.

Data type: Boolean
_VERTICAL_SCROLL_LOCKED
Specifies whether the vertical scrolling is locked or not.

Data type: Boolean

Visual SCIL Objects
VS_ICON_VIEW
_VIEW_BY
Specifies whether the icons in view are displayed as large or small icons. The large and small icons
can be set using methods _SET_ICON_IMAGE_LARGE and _SET_ICON_IMAGE_SMALL. Note
that if neither large nor small icon has not been defined, the default icon is used.

BY_LARGE_ICON and BY_SMALL_ICON.
Data type: Text
Default value: "BY_LARGE_ICON"
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
16.2.4 Predefined Methods GUID-97901ECC-BDDA-49AA-AA8B-969A7D80D865 v1
_APPEND_ICON
Appends an icon into the icon view. The number returned by this function must be used in all
subsequent references to the icon. The image of the icon is set using methods
_SET_ICON_IMAGE_LARGE and _SET_ICON_IMAGE_SMALL.
_ARRANGE
Arranges the icon view so that the icons are displayed as non-overlapping.
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_ICON_NAME
Returns the name of the specified icon.

Visual SCIL Objects
VS_ICON_VIEW

Parameter(s)
ICON_ID Integer
An integer value.
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_IS_ICON_SELECTED
The method returns TRUE if the specified icon is currently selected.
Return value data type: Boolean

Parameter(s)
ICON_ID Integer
An integer value.
_REMOVE_ICON
Removes the specified icon from the icon view.

Parameter(s)
ICON_ID Integer
An integer value.
_SET_ICON_IMAGE_LARGE
Sets the large image of the specified icon. The image can be loaded from a resource file or created
at runtime.

Parameter(s)
ICON_ID Integer
An integer value.
IMAGE Image reference
A reference to a VS_IMAGE object. A VS_IMAGE can be
_SET_ICON_IMAGE_SMALL
Sets the small image of the specified icon. The image can be loaded from a resource file or created
at runtime.

Visual SCIL Objects
VS_ICON_VIEW

Parameter(s)
ICON_ID Integer
An integer value.
_SET_ICON_NAME
Sets the name of the specified icon.

Parameter(s)
ICON_ID Integer
An integer value.
NAME Text

Visual SCIL Objects
166
VS_IMAGE
Section 17 VS_IMAGE GUID-69BA3F1D-78DC-450E-8E04-68217C5FC5C5 v1
17.1 Overview GUID-81DCE018-ADFB-47AD-8634-092D7E475A2E v1
A VS_IMAGE is a bitmap image that can be created dynamically or loaded using the .LOAD
command. The VS_IMAGE can be programmatically manipulated on pixel level, or by using the SCIL
drawing functions. The VS_IMAGE also has methods for importing and exporting external bitmap
files.
17.1.1 Predefined Attributes GUID-14C54263-C03A-4253-B131-9C3B6E5BD312 v1
Name Type
"_COLOR_COUNT" Integer
"_HEIGHT" Integer
"_IS_TRUE_COLOR" Boolean
"_WIDTH" Integer
17.1.2 Predefined Methods GUID-64303CEA-2592-4713-8B90-131E9DE19FA4 v1
Name Type
"_EXPORT_DIB" No return value
"_FILL_PIXMAP" No return value
"_GET_PIXMAP_MASK_AT" Integer
"_GET_PIXMAP_VALUE_AT" Integer
"_IMPORT_DIB" No return value
"_SET_PALETTE_COLOR_AT" No return value
"_SET_PIXMAP_MASK_AT" No return value
"_SET_PIXMAP_VALUE_AT" No return value
"_SET_SIZE" No return value
"_SET_SIZE_PRESERVE" No return value
17.2 Details GUID-BB00472A-DECC-48AD-902E-C7ACFAE40F4C v1
17.2.1 Predefined Attributes GUID-5C1D2B59-FC1B-4766-8A6F-24FCFC354580 v1
_COLOR_COUNT
Specifies the number of colors used in the palette of a certain image.

Data type: Integer
Default value: 2
_HEIGHT
Specifies the height of an image in pixels.

Visual SCIL Objects
VS_IMAGE

Data type: Integer
Default value: 10
Access: Read-only
_IS_TRUE_COLOR
Specifies whether an image is true color. True color images do not have a color palette, but contain
24-bit RGB pixmap values between 1 and 16777216 (2^24). When _IS_TRUE_COLOR changes its
value, all pixmap values are automatically converted.
The attribute _COLOR_COUNT cannot be changed if _IS_TRUE_COLOR is TRUE.
Large true color images require sufficient operating system memory resources to be
edited and displayed. Below are listed the memory requirements for large true color
images to be loaded:
640x480 - 921,600 bytes
800x600 - 1,440,000 bytes
960x720 - 2,073,600 bytes
1280x960 - 3,686,400 bytes

Data type: Boolean
_WIDTH
Specifies the width of an image in pixels.

Data type: Integer
Default value: 10
Access: Read-only
17.2.2 Predefined Methods GUID-D0E38EF2-DED4-4C29-85EF-4181AD8E8681 v1
_EXPORT_DIB
Exports a Windows bitmap (Device Independent Bitmap) to the file specified by PATH.

Parameter(s)
PATH Text
A text string representing the physical path.
_FILL_PIXMAP
Fills a pixmap (a two dimensional array of pixels) with the specified value.

Visual SCIL Objects
VS_IMAGE

Parameter(s)
VALUE Integer
An integer value representing a reference to a particular
color in the pixmap color palette.
_GET_PIXMAP_MASK_AT
Returns the pixmap mask at specified location with a specified value.

Parameter(s)
X Integer
An integer value.
Y Integer
An integer value.
VERT_HORIZ Text
VERTICAL and HORIZONTAL.
VALUE Integer
_GET_PIXMAP_VALUE_AT
Returns the pixmap (a two dimensional array of pixels) value in the specified location.

Parameter(s)
X Integer
An integer value.
Y Integer
An integer value.
_IMPORT_DIB
Imports a Windows bitmap (Device Independent Bitmap) from the a specified by PATH. The files
generally have the extension .BMP, although some DIBs can be found with the extension .DIB. The
import function only changes the image part, the programs, if any, are preserved.

Parameter(s)
PATH Text
A text string representing the physical path.
_SET_PALETTE_COLOR_AT
Specifies the used color in image palette with specified index.

Visual SCIL Objects
VS_IMAGE

Parameter(s)
INDEX Integer
An integer value.
COLOR Color
_SET_PIXMAP_MASK_AT
Sets the current pixmap value in a location masked with specified mask according to the value.

Parameter(s)
X Integer
An integer value.
Y Integer
An integer value.
VERT_HORIZ Text
MASK Integer
An integer value.
VALUE Integer
_SET_PIXMAP_VALUE_AT
Sets the pixmap (a two dimensional array of pixels) location with a specified value.

Parameter(s)
X Integer
An integer value.
Y Integer
An integer value.
VALUE Integer
_SET_SIZE
Sets the size of an image. The content of the image is not preserved.

Parameter(s)
W Integer
An integer value.
H Integer
An integer value.
_SET_SIZE_PRESERVE
Sets the size of an image. The content of the image is preserved according to the specified flags.

Visual SCIL Objects
VS_IMAGE

Parameter(s)
W Integer
An integer value.
H Integer
An integer value.
PRESERVE Vector
PRESERVE_HORIZ_LEFT,
PRESERVE_HORIZ_CENTER,
PRESERVE_HORIZ_RIGHT, PRESERVE_VERT_TOP,
PRESERVE_VERT_CENTER,
PRESERVE_VERT_BOTTOM and
PRESERVE_CLEAR_EXPOSED.
PRESERVE_HORIZ_LEFT: Will preserve the Horizontal
Left portion of image in the space provided for image,
usually the bottom left corner portion.
PRESERVE_HORIZ_CENTER: Will preserve the
Horizontally center portion of image in the space
provided for image, usually the bottom center portion.
PRESERVE_HORIZ_RIGHT: Will preserve the
Horizontally right portion of image in the space provided
for image, usually the bottom right corner portion.
PRESERVE_VERT_TOP: Will preserve the vertical Top
portion of the image in the space provided for image,
usually the left top corner portion.
PRESERVE_VERT_CENTER: Will preserve the vertical
center portion of the image in the space provided for
image, usually the left center portion.
PRESERVE_VERT_BOTTOM: Will preserver the vertical
bottom portion of the image in the space provided for
image, usually the left bottom portion
PRESERVE_CLEAR_EXPOSED: Will not draw the
image.
The view mainly depend on the size of the image provided in this function, e.g :
._set_size_preserve(w, h, preserve, value) :
root\myimage._set_size_preserve(40, 40, "PRESERVE_HORIZ_CENTER", 40)
Here w = 40,h = 40 and value = 40
VALUE Integer
color in the image color palette.

Visual SCIL Objects
172
VS_IMAGE_DOMAIN
Section 18 VS_IMAGE_DOMAIN GUID-840D18BF-BA91-4FC1-92D5-8F7040DCE665 v1
18.1 Overview GUID-A7757566-EAE7-486B-AE90-6B421461C604 v1
The VS_IMAGE_DOMAIN is an object that can contain an arbitrary number of different sized images.
VS_IMAGE objects can be attached into VS_IMAGE_DOMAIN.
18.1.1 Action Attributes GUID-2BBFE1D8-D6F6-4CA0-857B-07FC97983B05 v1
Name Type
18.1.2 Action Methods GUID-1B816055-95E2-484B-AFBE-799D06F757A2 v1
Name Type
18.1.3 Predefined Attributes GUID-D5F9EA46-BA1B-489C-956B-F07E835DEEBD v1
Name Type
"_DRAG_OUTLINE" Text
"_DRAG_POLICY" Text
"_DRAG_PROHIBITED" Boolean
"_DRAG_THRESHOLD" Integer
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_HORIZONTAL_GRID" Integer

Visual SCIL Objects
VS_IMAGE_DOMAIN
"_LIVE_SELECTION_ENABLED" Boolean
"_OBJECT_NAME" Text
"_SCALE_X" Integer
"_SCALE_Y" Integer
"_SELECT_ENCLOSED_ENABLED" Boolean
"_SELECTED_OBJECTS" Integer
"_SHOW_IMAGE_BORDER_ENABLED" Boolean
"_SINGLE_SELECTION_ENABLED" Boolean
"_SNAP_TO_GRID_ENABLED" Boolean
"_VERTICAL_GRID" Integer
"_VISIBLE" Boolean
18.1.4 Predefined Methods GUID-C9309210-E7DB-482E-B6C6-31C7AE8DCE9C v1
Name Type
"_APPEND_IMAGE" Integer
"_GET_IMAGE_LABEL" Text
"_GET_IMAGE_LABEL_HEIGHT" Integer
"_GET_IMAGE_LABEL_WIDTH" Integer
"_GET_IMAGE_X" Integer
"_GET_IMAGE_Y" Integer
"_GET_SELECTED_IMAGE" Integer
"_INVALIDATE_IMAGE" No return value
"_REMOVE_IMAGE" No return value
"_REPLACE_IMAGE" No return value
"_SET_IMAGE_ANCHORED" No return value
"_SET_IMAGE_LABEL" No return value
"_SET_IMAGE_LABEL_BACKGROUND_COLOR" No return value
"_SET_IMAGE_LABEL_FOREGROUND_COLOR" No return value
"_SET_IMAGE_SELECTABLE" No return value

Visual SCIL Objects
VS_IMAGE_DOMAIN
"_SET_IMAGE_X" No return value

"_SET_IMAGE_Y" No return value
"_SET_SELECTED_IMAGE" No return value
18.2 Details GUID-298033F4-0AFB-4A8B-8A8A-714AF010462D v1
18.2.1 Action Attributes GUID-28700D3E-47F4-460F-BEB6-3371C3782D01 v1
_DOUBLE_CLICK
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN
18.2.2 Action Methods GUID-86F88077-6C38-4D87-8C80-262320EF2B8C v1
DOUBLE_CLICK
The DOUBLE_CLICK program is run whenever the user double-clicks an image in the image
domain. When a double-click occurs, the user can find out which image was clicked with the method
_GET_SELECTED_IMAGE.
NOTIFY
TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_IMAGE_DOMAIN
18.2.3 Predefined Attributes GUID-F70F9422-1443-4761-8915-8B34F85FC73C v1
_ATTRIBUTE_NAMES
Designates whether or not the view is automatically scrolled when an object is moved outside of the
view area of the object.

Data type: Boolean
Example:
.SET MY_DOMAIN._AUTO_SCROLL_ENABLED = TRUE
_BACKGROUND_COLOR
Example:
_BOUNDS_GEOMETRY
The _BOUNDS_GEOMETRY is the entire virtual coordinate space of the image domain. Position
(0,0) in the image domain coordinate system is at the lower left corner of the
_BOUNDS_GEOMETRY. The _BOUNDS_GEOMETRY is interpreted in the same coordinate space
as the _GEOMETRY of the object. Each object in the image domain is placed relative to the lower
left corner of the _BOUNDS_GEOMETRY.

system.
Data type: List
Default value: (X=0,Y=0,W=100,H=100)
_CHILD_OBJECTS
For more information, see Section 3s.
_CLICK_FOCUSABLE

Data type: Boolean
Example:

Visual SCIL Objects
VS_IMAGE_DOMAIN
_DRAG_OUTLINE
Specifies the outlining method when dragging objects within the view.

OUTLINE_ALL, OUTLINE_TWO, OUTLINE_LIMITRECT
and OUTLINE_NONE.
Data type: Text
_DRAG_POLICY
Specifies the dragging policy to be used when dragging objects.
Description: A text string containing one of the following

keywords:DRAG_NORMAL, DRAG_AUTOSCROLL and
EXTERNAL_DRAG.
Data type: Text
_DRAG_PROHIBITED
Specifies whether or not dragging is prohibited for all objects within the view.

Data type: Boolean
_DRAG_THRESHOLD
Specifies the drag threshold to be used when dragging objects within the view. The drag threshold is
the amount of movement that is required initially (in pixels) to begin dragging the object.

Data type: Integer
_ENABLED

Visual SCIL Objects
VS_IMAGE_DOMAIN

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY

Visual SCIL Objects
VS_IMAGE_DOMAIN
Example:
Specifies whether clicking and dragging the mouse in a view invokes the Grabbing hand or simply
view as if the user grabbed it, so that scrolling of the view and the movement of the mouse are
synchronous.

Data type: Boolean
_HAS_BORDER

Data type: Boolean
Example:
_HORIZONTAL_GRID
Specifies whether the horizontal grid is used in image domain or not. When this attribute is set to
TRUE, the horizontal line is drawn in every row.

Data type: Integer
Default value: 0

Data type: Boolean
Specifies whether horizontal scrolling is locked or not.

Visual SCIL Objects
VS_IMAGE_DOMAIN

Data type: Boolean
_LIVE_SELECTION_ENABLED
Specifies how selected objects in the view become highlighted. When this attribute is set to TRUE,
live selection actively selects and unselects objects as tracking with the marquee occurs, rather than
selecting after the mouse button has been released.

Data type: Boolean
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
the object.

Example:
_SCALE_X
Specifies the width amount to scale the image in domain.

Data type: Integer
Default value: 100
_SCALE_Y
Specifies the height amount to scale the image in domain.

Visual SCIL Objects
VS_IMAGE_DOMAIN

Data type: Integer
Default value: 100
_SCIL_GEOMETRY
_SELECT_ENCLOSED_ENABLED
Specifies how objects in the view become selected. Setting this attribute to TRUE means that objects
in the view are selected only when completely enclosed within the selection marquee. When the
attribute is set to FALSE, the objects become selected if any part of the object lies within the
selection marquee.

Data type: Boolean
_SELECTED_OBJECTS
Specifies the selected images in domain view. When the attribute _SINGLE_SELECTION_ENABLED
is set to TRUE, only one image can be selected at a time.

Data type: Integer
Access: Read-only
_SHOW_IMAGE_BORDER_ENABLED
Specifies whether the image border is shown in the image domain.

Data type: Boolean
_SINGLE_SELECTION_ENABLED
Specifies whether single selection is used in domain view or not. When
_SINGLE_SELECTION_ENABLED attribute is set to TRUE, only one image can be selected at a
time.

Data type: Boolean

Visual SCIL Objects
VS_IMAGE_DOMAIN
_SNAP_TO_GRID_ENABLED
Specifies whether Snap to grid is used or not. Snap to grid means that objects that are moved to a
new location in the domain are aligned according to a grid.

Data type: Boolean
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Specifies the tooltip text that appears over an object when the cursor is held overe the object.
Data type: Text
Example:
_VARIABLE_NAMES
_VERTICAL_GRID
Specifies whether a vertical grid is used in image domain or not. When this attribute is set to TRUE,
the vertical line is drawn in every column.

Data type: Integer
Default value: 0

Data type: Boolean
Specifies whether vertical scrolling is locked or not.

Visual SCIL Objects
VS_IMAGE_DOMAIN

Data type: Boolean
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
18.2.4 Predefined Methods GUID-47AFA810-29F8-478F-B146-53A69EDA15F9 v1
_APPEND_IMAGE
Appends an image to the image domain.

Parameter(s)
X Integer
An integer value.
Y Integer
An integer value.
IMAGE Image reference A reference to a VS_IMAGE object. A
VS_IMAGE can be created using the SCIL
function .CREATE or loaded using the function .LOAD.
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_IMAGE_LABEL
Returns the label of a specified image.

Parameter(s)
IMAGE_ID Integer
An integer value.

Visual SCIL Objects
VS_IMAGE_DOMAIN
_GET_IMAGE_LABEL_HEIGHT
Returns the label height of a specified image.

Parameter(s)
IMAGE_ID Integer
An integer value.
_GET_IMAGE_LABEL_WIDTH
Returns the label width of a specified image.

Parameter(s)
IMAGE_ID Integer
An integer value.
_GET_IMAGE_X
Returns the x-coordinate of a specified image.

Parameter(s)
IMAGE_ID Integer
An integer value.
_GET_IMAGE_Y
Returns the y-coordinate of a specified image.

Parameter(s)
IMAGE_ID Integer
An integer value.
_GET_SELECTED_IMAGE
Returns the selected image identification.
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_INVALIDATE_IMAGE
Invalidates the specified image.

Visual SCIL Objects
VS_IMAGE_DOMAIN

Parameter(s)
IMAGE_ID Integer
An integer value.
_REMOVE_IMAGE
Removes a specified image from the image domain.

Parameter(s)
IMAGE_ID Integer
An integer value.
_REPLACE_IMAGE
Replaces a specified image with another image.

Parameter(s)
ID Integer
An integer value.
_SET_IMAGE_ANCHORED
Specifies whether an image is anchored or not. Anchored image can be selected but cannot be
moved.

Parameter(s)
IMAGE_ID Integer
An integer value.
ANCORED Boolean
_SET_IMAGE_LABEL
Specifies an image label.

Parameter(s)
IMAGE_ID Integer
An integer value.

Visual SCIL Objects
VS_IMAGE_DOMAIN
LABEL Text
LABEL_POSITION_X Vector
PLACE_NEAR: Completely outside with a small margin
PLACE_ADJACENT: Completely outside with no margin
PLACE_STRADDLE: Half inside, half outside
PLACE_ALIGN: Completely inside with no margin
PLACE_INSET: Completely inside with a small margin
PLACE_HALF: Opposite side touches centre of base
dialog
PLACE_CENTER: Centered inside
LABEL_POSITION_Y Vector
PLACE_NEAR: Completely outside with a small margin
PLACE_ADJACENT: Completely outside with no margin
PLACE_STRADDLE: Half inside, half outside
PLACE_ALIGN: Completely inside with no margin
PLACE_INSET: Completely inside with a small margin
PLACE_HALF: Opposite side touches centre of base
dialog
PLACE_CENTER: Centered inside
_SET_IMAGE_LABEL_BACKGROUND_COLOR
Specifies the background of an image label.

Parameter(s)
ID Integer
An integer value.
COLOR Color
_SET_IMAGE_LABEL_FOREGROUND_COLOR
Specifies the foreground of an image label.

Parameter(s)
ID Integer
An integer value.
COLOR Color
_SET_IMAGE_SELECTABLE
Specifies whether an image can be selected or not.

Visual SCIL Objects
VS_IMAGE_DOMAIN

Parameter(s)
IMAGE_ID Integer
An integer value.
SELECTABLE Boolean
_SET_IMAGE_X
Specifies the X coordinate of an image.

Parameter(s)
IMAGE_ID Integer
An integer value.
X Integer
An integer value.
_SET_IMAGE_Y
Specifies the Y coordinate of an image.

Parameter(s)
IMAGE_ID Integer
An integer value.
Y Integer
An integer value.
_SET_SELECTED_IMAGE
Specifies an image as selected.

Parameter(s)
IMAGE_ID Integer
An integer value.

Visual SCIL Objects
188
VS_IMAGE_EDITOR
Section 19 VS_IMAGE_EDITOR GUID-2A359AF8-5729-4258-9E74-C80D1212A897 v1
19.1 Overview GUID-B2839C0F-E6E1-4A42-9509-6916900C27C9 v1
The VS_IMAGE_EDITOR is an editor with which the user can edit, import and export bitmap
graphics. It is also possible to create transparent bitmaps.
19.1.1 Action Attributes GUID-CE80D152-E01E-45CC-B68C-0D57F8CE23C9 v1
Name Type
"_APPLY_IMAGE" Text vector
19.1.2 Action Methods GUID-E4F453A4-41D0-4004-8151-4439BE9242EF v1
Name Type
"APPLY_IMAGE" No return value
19.1.3 Predefined Attributes GUID-62D1BF72-55EC-4D54-B90B-06B159E7D832 v1
Name Type
"_BIT_SIZE" Integer
"_BUSY" Boolean
"_FONT" Font
"_GEOMETRY" List
"_GRID_ENABLED" Boolean
"_HAS_SELECTION" Boolean
"_IS_MODIFIED" Boolean

Visual SCIL Objects
VS_IMAGE_EDITOR
"_OBJECT_NAME" Text
"_OPEN" Boolean
"_SHOW_LOCATION_ENABLED" Boolean
"_STYLE" Vector
"_TITLE" Text
"_USER_MENUBAR" Menubar reference
19.1.4 Predefined Methods GUID-44489618-46E4-4E3A-8FDD-03D180577CF0 v1
Name Type
"_DROP_SELECTION" No return value
19.2 Details GUID-21B5845F-5F5E-4070-8FC3-09B0C22375B6 v1
19.2.1 Action Attributes GUID-C058BE0E-4564-483C-976E-5AAC76171A8A v1
_APPLY_IMAGE
Setting this attribute specifies the action method APPLY_IMAGE.
_CLOSE_NOTIFY
Example:

Visual SCIL Objects
VS_IMAGE_EDITOR
_NOTIFY
19.2.2 Action Methods GUID-94143D31-B6BA-4A80-926F-20880877E16B v1
APPLY_IMAGE
This action method is executed when the user closes the Image Editor using the menu File > Close.
CLOSE_NOTIFY
The CLOSE_NOTIFY action method is called immediately after the user closes a dialog. It is called
before the dialog is actually closed. If the method returns TRUE, the dialog is not closed. If it returns
FALSE, the dialog is closed normally. Note that the CLOSE_NOTIFY action method is not always
run. For example, it is not run when a dialog is deleted or closed by the program. Normal cleaning up
after a dialog should be done in the DELETE method of the dialog and not in the CLOSE_NOTIFY
method.
NOTIFY
specific object.
19.2.3 Predefined Attributes GUID-7F355E4B-FF7E-4114-BEFB-96597E47CA93 v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
_BIT_SIZE
Specifies the enlargement scale when the Image Editor displays the image that is being edited. A
value of 1 specifies 100%.

Data type: Integer
Default value: 5
_BUSY

Visual SCIL Objects
VS_IMAGE_EDITOR

Data type: Boolean
_CHILD_OBJECTS
_FILE_REVISION
_FOCUSABLE
Designates whether a window should receive keyboard focus or not. Keyboard focus policy is
dependent on the window system, and this function only indicates that the window is useful for key

Data type: Boolean
Default value: TRUE
_FONT
_FOREGROUND_COLOR
_GEOMETRY
_GRID_ENABLED
Specifies whether the Image Editor shows a grid.

Data type: Boolean
_HAS_SELECTION
Specifies whether an image has been selected in Image Editor or not.

Visual SCIL Objects
VS_IMAGE_EDITOR

Data type: Boolean
Access: Read-only
_ICON
Specifies the icon used in the title of a window or when a window is iconified. Note that the _ICON
attribute must be set from at least one object hierarchy level upper than the window itself, otherwise
the delete method of the window is not allowed. The text assigned into attribute contains the image
reference.

Example:
_ICONIFIED
Designates whether a window is iconified or not. The exact implication of iconification depends on
the window system and window manager in use. The window manager lets user manipulate

Data type: Boolean
_IMAGE
Specifies the image reference to the image being edited in Image Editor.

_IS_MODIFIED
This read-only attribute shows whether the image was modified in the image editor or not.

Visual SCIL Objects
VS_IMAGE_EDITOR

Data type: Boolean
Access: Read-only
_LEADER_DIALOG
destroyed, the other dialog's reference to it is deleted automatically. The _LEADER_DIALOG
its class. For example, _ICON, _FOREGROUND_COLOR, _BACKGROUND_COLOR and _FONT
are inherited.

Access: Write-only
_LEADER_DIALOG_ITEM
Like the _LEADER_DIALOG attribute, the _LEADER_DIALOG_ITEM attribute defines a leader

dialog for the given window. The leader dialog is the one that holds the item specified. Setting this
attribute to empty text unsets the leader dialog for the given window. For more information about
leader-follower dialogs relationship, see the description of the _LEADER_DIALOG attribute.
This attribute can be used, for example, in picture methods, setting picture container as the leader
context.
Example:
_MAX_HEIGHT
_MAX_WIDTH
_MAXIMIZED
maximum size or the entire display, whichever is smaller. The window's current position and size are
saved for later restoration by setting the attribute to FALSE.

Visual SCIL Objects
VS_IMAGE_EDITOR

Data type: Boolean
_MIN_HEIGHT
_MIN_WIDTH
_OBJECT_CLASS
_OBJECT_NAME
_OPEN

Data type: Boolean
_SCIL_GEOMETRY
_SHOW_LOCATION_ENABLED
Specifies whether the Image Editor continuously displays the position of the cursor when editing an
image.

Data type: Boolean
_SOURCE_FILE_NAME
_STYLE
The style flags determine which decorations, if any, are placed around the window's border, as well
as how the user can directly manipulate the window. Note that the visual effect of setting style flags is

Visual SCIL Objects
VS_IMAGE_EDITOR

STYLE_BACKGROUND
This attribute sets the opacity of the window. Without the STYLE_BACKGROUND attribute the
window will contain a border, along with header information, and the Iconfiable, Maximize &
Unclosable icons.
STYLE_DOCUMENT
The visual effect of setting style flags is platform dependent. Not all platforms can distinguish all

Data type: Vector
"STYLE_RESIZABLE")
_TITLE
The title of a window. Note that the title may not be visible under certain circumstances, for example
if the window or dialog does not have a title bar.

Data type: Text
_USER_MENUBAR
Setting the attribute _USER_MENUBAR to have a text reference to a VS_MENUBAR replaces the
original menubar of the VS_IMAGE_EDITOR. To gain control over the image editor the menu items
need to conform to the command names of the image editor. The commands are as follows:

Visual SCIL Objects
VS_IMAGE_EDITOR
ApplyEditor Commits the changes made in an image editor to the

original image and calls the image editor's apply function.
Clear Clears the current selection in an image editor.
CloseEditor Closes an image editor dialog.
Copy Copies the current selection in an image editor to the
scrap.
CreateTransparency Creates a transparency for the image being edited in an
image editor.
CropSelection Crops the image being edited to the current selection in
an image editor.
Cut Copies the current selection in an image editor to the
scrap and clears the current selection.
DeleteTransparency Deletes the transparency associated with the image
being edited by an image editor.
DrawCenter Toggles the draw centre option of an image editor.
EditPalette Opens the color palette editor to edit the color palette
associated with the image being edited.
Export Opens the export file chooser to allow the user to export
the image being edited in an image editor.
FatBits Toggles the magnification of bits in an image editor.
FlipHor Flips the selected bits in an image editor horizontally.
FlipVer Flips the selected bits in an image editor vertically.
Import Opens the import file chooser to allow the user to import
an image to edit in an image editor.
MaskSelection Creates an initial transparency mask reflecting the
current selection in an image editor.
Paste Pastes the contents of the scrap into the image being
edited by an image editor.
Preview Toggles the visible state of the preview window for an
image editor.
Redo Selects the redo of the last action available in the undo
log for an image editor.
Revert Reverts the image being edited in an image editor to the
last saved state.
Rotate Rotates the current selection in an image editor 90
degrees.
SetFont Opens the font chooser to allow the user to change the
default font of an image editor.
SetSize Opens the set size confirmation dialog to change the size
of the image being edited in an image editor.
ShowGrid Toggles the grid option for an image editor.
ShowPosition This can be done only once for an
object.

Visual SCIL Objects
VS_IMAGE_EDITOR
Description: A reference to a VS_MENUBAR object. A

VS_MENUBAR can be created using the SCIL
function .CREATE or loaded from a file using the
function .LOAD.
Data type: Menubar reference
Access: Write-only
_VARIABLE_NAMES
19.2.4 Predefined Methods GUID-633B7CA0-E456-497F-BD36-A6AE60B542A2 v1
_DROP_SELECTION
Drops the selected image in Image Editor.
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_POINTER_POS
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_PLACE
Positions a dialog's relative placement compared to another dialog. The BASE parameter specifies
the dialog to be used as base for the positioning. The parameters X_FLAGS and Y_FLAGS specify
the relation to BASE on the different coordinate axes. The following flags specify which side is used
PLACE_BOTTOM.

Visual SCIL Objects
VS_IMAGE_EDITOR
PLACE_STRADDLE = Half inside, half outside
PLACE_INSET = Completely inside with a small margin
left out, because both sides are automatically used when centring.

Parameter(s)
X_FLAGS Vector
Y_FLAGS Vector
Example:

Positions a dialog's relative placememt compared to the given rectangle in the coordinate system of
a dialog item. The BASE and RECT parameters specify the dialog item and the rectangle to be used
new coordinates: PLACE_LEFT, PLACE_RIGHT, PLACE_TOP and PLACE_BOTTOM.
Usually, BASE specifies a kind of container (VS_CONTAINER, VS_NOTEBOOK_PAGE, etc.), and

RECT is the geometry of a direct child item of that container. However, it is possible to specify any
dialog item as BASE, and any rectangle as RECT.

Visual SCIL Objects
VS_IMAGE_EDITOR
left out, because both sides are automatically used when centering.

Parameter(s)
BASE Dialog Item
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:



Positions a dialog's relative placement compared to given rectangle. The RECT parameter specifies
PLACE_BOTTOM.

Visual SCIL Objects
VS_IMAGE_EDITOR

Parameter(s)
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
Positions a dialog's relative placement compared to a given SCIL rectangle. The RECT parameter
specifies the coordinates to be used as base for the positioning. The parameters X_FLAGS and
Y_FLAGS specify the relation to RECT on the different coordinate axes. The following flags specify
which side is used when determining the new coordinates: PLACE_LEFT, PLACE_RIGHT,
PLACE_TOP and PLACE_BOTTOM.

Visual SCIL Objects
VS_IMAGE_EDITOR

Parameter(s)
RECT List
X_FLAGS Vector
Y_FLAGS Vector
Example:
_RAISE
_SET_MAX_SIZE
_SET_MIN_SIZE

Visual SCIL Objects
VS_INPUT_DIALOG
Section 20 VS_INPUT_DIALOG GUID-143BB84A-EB74-446B-81D4-B020DEBEA723 v1
20.1 Overview GUID-B2518C71-7C1C-487A-B196-F6152186BD68 v1
A VS_INPUT_DIALOG is used to ask for an input string from the user. The attribute
_PROMPT_TEXT specifies the text to be displayed and _INPUT_TEXT is used to set a default
string, as well as read the string given by the user. The _PROMPT_TEXT has to be set before the
dialog is opened, otherwise the dialog is not automatically resized according to the amount of text.
The string, which should be read, can be placed in the APPLY action method. The APPLY action
method is executed when the user clicks the OK or Apply button.
20.1.1 Action Attributes GUID-609DB706-71F7-4FEE-98E1-7612550F9661 v1
Name Type
"_APPLY" Text vector
"_DEFAULTS" Text vector
"_HELP" Text vector
20.1.2 Action Methods GUID-7E821696-6A27-41C7-AEF4-35B2B66C414E v1
Name Type
"APPLY" Boolean
"DEFAULTS" Boolean
"HELP" Boolean
20.1.3 Predefined Attributes GUID-5F687633-D910-4E50-9EF5-9CFE2A8FAA4D v1
Name Type
"_BUSY" Boolean
"_BUTTONS_VERTICALLY" Boolean
"_FONT" Font
"_GEOMETRY" List
"_HAS_APPLY" Boolean
"_HAS_CANCEL" Boolean
"_HAS_DEFAULTS" Boolean

Visual SCIL Objects
VS_INPUT_DIALOG
"_HAS_HELP" Boolean
"_HAS_OK" Boolean
"_INPUT_TEXT" Text
"_MODAL" Boolean
"_OBJECT_NAME" Text
"_OPEN" Boolean
"_PROMPT_TEXT" Text
"_STYLE" Vector
"_TITLE" Text
20.1.4 Predefined Methods GUID-50736F89-3DB5-451D-9141-15FC72849F77 v1
Name Type

Visual SCIL Objects
VS_INPUT_DIALOG
20.2 Details GUID-44203385-D535-4CFB-9859-09F60D7CB42F v1
20.2.1 Action Attributes GUID-99CA2556-7B6A-48FD-B4AF-72F50BA13123 v1
_APPLY
Setting this attribute specifies the action method APPLY.
Example:
.SET MY_DIALOG._APPLY = (“ROOT.APPLY_DIALOG“, ““)
_CLOSE_NOTIFY
Example:
_DEFAULTS
Setting this attribute specifies the action method DEFAULTS.
Example:
.SET MY_DIALOG._DEFAULTS = (“ROOT.DEFAULTS_DIALOG“, ““)
_HELP
Setting this attribute specifies the action method HELP.
Example:
.SET MY_DIALOG._HELP = (“ROOT.HELP_DIALOG“, ““)
_NOTIFY
20.2.2 Action Methods GUID-294E0A08-888F-4C23-85E9-CD4D69A15F53 v1
APPLY
Specifies the action method that is executed when the Apply button is clicked in the confirmation
dialog. If this action method is not set, the dialog is closed by default when Apply is clicked. The
dialog is automatically closed if the user returns TRUE from this action method, when the Apply is
clicked.

Visual SCIL Objects
VS_INPUT_DIALOG
CLOSE_NOTIFY
The CLOSE_NOTIFY action method is called immediately after the user chose to close the dialog. It
is called before the dialog is actually closed. If the method returns TRUE, the dialog is not closed. If it
always run. For example, it is not run when a dialog is deleted or closed by the program. Normal
DEFAULTS
Specifies the action method that is executed when the Defaults button is pressed in the confirmation
dialog.
HELP
Specifies the action method that is executed when the Help button is pressed in the confirmation
dialog.
NOTIFY
Specifies the notification procedure for an object. The notification procedure gets called for different
specific object.
20.2.3 Predefined Attributes GUID-409C9B6B-219A-48F9-B5D9-4D92991D352A v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
_BUSY

Data type: Boolean
_BUTTONS_VERTICALLY
Specifies that the buttons within the confirmation dialog should be arranged vertically instead of
horizontally. The default is horizontal arrangement.

Visual SCIL Objects
VS_INPUT_DIALOG

Data type: Boolean
Example:
.SET MY_DIALOG._BUTTONS_VERTICALLY = TRUE
_CHILD_OBJECTS
_FILE_REVISION
_FOCUSABLE
dependent on the window syste, and this function only indicates that the window has use for key

Data type: Boolean
Default value: TRUE
_FONT
_FOREGROUND_COLOR
_GEOMETRY
_HAS_APPLY
Specifies whether the confirmation dialog has an Apply button or not.

Data type: Boolean
Example:
.SET MY_DIALOG._HAS_APPLY = FALSE

Visual SCIL Objects
VS_INPUT_DIALOG
_HAS_CANCEL
Specifies whether the confirmation dialog has a Cancel button or not.

Data type: Boolean
Example:
.SET MY_DIALOG._HAS_CANCEL = TRUE
_HAS_DEFAULTS
Specifies whether the confirmation dialog has a Defaults button or not.

Data type: Boolean
Example:
.SET MY_DIALOG._HAS_DEFAULTS = FALSE
_HAS_HELP

Data type: Boolean
Example:
_HAS_OK
Specifies whether the confirmation dialog has an OK button or not.

Data type: Boolean
Example:
.SET MY_DIALOG._HAS_OK = TRUE

Visual SCIL Objects
VS_INPUT_DIALOG
_ICON
reference.

Example:
_ICONIFIED

Data type: Boolean
_INPUT_TEXT
The text that the user has written into the text field. This attribute is also used to set a default value
when opening input dialog.

Data type: Text
_LEADER_DIALOG
destroyed, the other dialog's reference to it is deleted automatically. The _LEADER_DIALOG
are inherited.

Visual SCIL Objects
VS_INPUT_DIALOG

Access: Write-only
_LEADER_DIALOG_ITEM

leader-follower dialogs relationship, see description of the _LEADER_DIALOG attribute.
dialog as leader because the holding dialog is not accessible directly from the picture context.
Example:
_MAX_HEIGHT
_MAX_WIDTH
_MAXIMIZED

Data type: Boolean
_MIN_HEIGHT
_MIN_WIDTH
_MODAL

Visual SCIL Objects
VS_INPUT_DIALOG

Data type: Boolean
_OBJECT_CLASS
_OBJECT_NAME
_OPEN

Data type: Boolean
_PROMPT_TEXT
Specifies the text telling the user what to write into an input text field. The text is automatically
formatted to fit into the dialog. The user explicitly sets line breaks by inserting the ASCII(10)
character into the text. The _PROMPT_TEXT has to be set before the dialog is opened, otherwise
the dialog is not resized properly.

Data type: Text
Access: Write-only
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_STYLE


Visual SCIL Objects
VS_INPUT_DIALOG
STYLE_BACKGROUND
window will contain a border along with header information and the Iconfiable, Maximize &
Unclosable icons.
STYLE_DOCUMENT

Data type: Vector
Default value: ("STYLE_BACKGROUND","STYLE_BORDER",
"STYLE_CONFIRM","STYLE_MOVABLE")
_TITLE
The title of a window. Note that the title may not be visible under certain circumstances, for example
if the window or dialog does not have a title bar.

Data type: Text
_VARIABLE_NAMES
20.2.4 Predefined Methods GUID-2CAD2E06-313A-46DB-A798-99C8A68F6B4E v1
_FLAG_FOR_EXECUTION
_GET_HELP

Visual SCIL Objects
VS_INPUT_DIALOG
_GET_POINTER_POS
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_PLACE
Positions dialogs relative place compared to another dialog. The BASE parameter specifies the
PLACE_BOTTOM.

Visual SCIL Objects
VS_INPUT_DIALOG

Parameter(s)
X_FLAGS Vector
Y_FLAGS Vector
Example:

coordinates: PLACE_LEFT, PLACE_RIGHT, PLACE_TOP and PLACE_BOTTOM.
Usually, BASE specifies a kind of container (VS_CONTAINER,VS_NOTEBOOK_PAGE, etc.), and


Parameter(s)
BASE Dialog Item

Visual SCIL Objects
VS_INPUT_DIALOG
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:


Positions dialogs relative place compared to given rectangle. The RECT parameter specifies the
PLACE_BOTTOM.

Visual SCIL Objects
VS_INPUT_DIALOG

Parameter(s)
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
PLACE_BOTTOM.

Visual SCIL Objects
VS_INPUT_DIALOG

Parameter(s)
RECT List
X_FLAGS Vector
Y_FLAGS Vector
Example:
_RAISE
_SET_MAX_SIZE
_SET_MIN_SIZE

Visual SCIL Objects
218
VS_LABEL
Section 21 VS_LABEL GUID-BBE1A796-455C-46C9-8F44-A119950F9C33 v1
21.1 Overview GUID-016A02EB-F0F1-4AE4-AAC3-10B4BDFB4C59 v1
The VS_LABEL object is a dialog item that displays a text label. It does not contain any other
functionality.
21.1.1 Action Attributes GUID-4AA153B8-9336-43C6-8343-78F640E72BA2 v1
Name Type
21.1.2 Action Methods GUID-EC3AFB79-6451-4E94-838A-771F6902DF65 v1
Name Type
21.1.3 Predefined Attributes GUID-5955072C-F812-4968-B893-3E8965FACA8E v1
Name Type
"_ENABLED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_OBJECT_NAME" Text
"_TITLE" Text
"_VISIBLE" Boolean
21.1.4 Predefined Methods GUID-4BBCCD9F-0CCE-4C13-AD6C-B28800F01AB4 v1
Name Type

Visual SCIL Objects
VS_LABEL
21.2 Details GUID-66932454-C15A-4B4D-8847-E534ED5B23F0 v1
21.2.1 Action Attributes GUID-0B0AED1D-248E-4E5E-B888-A49FE784E6B9 v1
_TOOLTIP_IS_SHOWN
21.2.2 Action Methods GUID-97F835A5-8381-40F8-B700-2DB42B6F68A0 v1
TOOLTIP_IS_SHOWN
21.2.3 Predefined Attributes GUID-6491A881-6D77-438F-8A48-4C1E564500DA v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION

Visual SCIL Objects
VS_LABEL
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_OBJECT_CLASS
_OBJECT_NAME
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TITLE
Specifies the title of a dialog item.

Data type: Text
Example:
_TOOLTIP_TEXT
Specifies the tooltip text appearing over the object when the cursor is held over the object.
Data type: Text
Example:

Visual SCIL Objects
VS_LABEL
_VARIABLE_NAMES
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
21.2.4 Predefined Methods GUID-4C2ED939-47B7-47EA-83E5-21DA352FE593 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text

Visual SCIL Objects
VS_LINE
Section 22 VS_LINE GUID-B09126BD-307D-47BD-BA27-CC57F5E58D7F v1
22.1 Overview GUID-C0D6DDC0-DD50-426D-B53A-0622B305C854 v1
The VS_LINE object is a dialog item that displays a line. It does not contain any other functionality.
The appearance of the line depends of the platform on which it is displayed. The line will be drawn
horizontally or vertically depending on which one of the attributes _WIDTH and _HEIGHT in the
_GEOMETRY is larger. The line is drawn along the left or bottom side of the specified GEOMETRY
rectangle.
22.1.1 Action Attributes GUID-4563B8FB-F9A6-4ECE-9577-4F83D2A22C54 v1
Name Type
22.1.2 Action Methods GUID-782DD76E-BA2B-4703-83D4-105E24999415 v1
Name Type
22.1.3 Predefined Attributes GUID-69F86EA4-78DF-4DF6-ABE7-865C6CDC86F1 v1
Name Type
"_BOTTOM_SHADOW_COLOR" Color
"_GEOMETRY" List
"_LINE_STYLE" Text
"_OBJECT_NAME" Text
"_TOP_SHADOW_COLOR" Color
"_VISIBLE" Boolean

Visual SCIL Objects
VS_LINE
22.1.4 Predefined Methods GUID-52D83982-475E-40AD-8312-1908DB34FD0A v1
Name Type
22.2 Details GUID-33291EA8-AAD6-42F6-BF4A-66AC21ED969B v1
22.2.1 Action Attributes GUID-9B101BFE-19CD-451D-A9F1-B0F2BE66230C v1
_TOOLTIP_IS_SHOWN
22.2.2 Action Methods GUID-E25C4A50-364E-456C-86FF-12B95CA9A138 v1
TOOLTIP_IS_SHOWN
22.2.3 Predefined Attributes GUID-548298F6-2ACB-4F88-BFDD-6CCDAB221CF3 v1
_ATTRIBUTE_NAMES
_BOTTOM_SHADOW_COLOR
The color used to draw the darker side of a line, if it is in 3D mode (_LINE_STYLE is STYLE_INSET
or STYLE_OUTSET).
_CHILD_OBJECTS
_FILE_REVISION
_FOREGROUND_COLOR
Specifies the foreground color for a dialog item. The foreground color is, for example, the color which
is used when drawing the tile of an object.
Example:

Visual SCIL Objects
VS_LINE
.SET MY_OBJECT._FOREGROUND_COLOR=(65535, 0, 0)
_GEOMETRY
Example:
_LINE_STYLE
One of STYLE_INSET, STYLE_OUTSET, STYLE_SOLID or STYLE_DASHED. Defines the line

drawing style.
_OBJECT_CLASS
_OBJECT_NAME
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Specifies the tooltip text that appears over an object when the cursor is held over it.
Data type: Text
Example:
_TOP_SHADOW_COLOR
The color used to draw the lighter side of a line, if it is in 3D mode (_LINE_STYLE is STYLE_INSET
or STYLE_OUTSET).
_VARIABLE_NAMES
_VISIBLE

Visual SCIL Objects
VS_LINE

Data type: Boolean
Default value: TRUE
Example:
22.2.4 Predefined Methods GUID-5A355BD1-B86D-437D-A5EF-0650988B9969 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text

Visual SCIL Objects
VS_LIST
Section 23 VS_LIST GUID-57117EAF-25E3-4DE7-9E11-D44852706A3E v1
23.1 Overview GUID-B284DF3E-7D99-4FCD-9601-B302FD92435D v1
The VS_LIST object is a list that can contain an arbitrary amount of rows and columns. The NOTIFY
method of the VS_LIST is run whenever the selected cell of the list has changed. The content of a
cell or cell areas can be set or read by using predefined methods.
23.1.1 Action Attributes GUID-40E4DB3E-3C80-4217-B033-5DD14349703B v1
Name Type
23.1.2 Action Methods GUID-25D37A60-82EF-4BDE-839C-6F4E4F73BE9B v1
Name Type
23.1.3 Predefined Attributes GUID-350C11AB-9701-4DBE-9EF7-09F23AC533FD v1
Name Type
"_DRAWING_SELECTION_ENABLED" Boolean
"_ENABLED" Boolean
"_EXTEND_COLUMN_SELECTION_ENABLED" Boolean
"_EXTEND_ROW_SELECTION_ENABLED" Boolean
"_FIRST_VISIBLE_COLUMN" Integer

Visual SCIL Objects
VS_LIST
"_FIRST_VISIBLE_ROW" Integer
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_HORIZONTAL_GRID_ENABLED" Boolean
"_KEYBOARD_SELECTION_ENABLED" Boolean
"_KEYBOARD_TRAVERSAL_ENABLED" Boolean
"_OBJECT_NAME" Text
"_ROW_COUNT" Integer
"_SELECTED_CELLS" Integer
"_SELECTED_ROW" Integer
"_SELECTION_POLICY" Text
"_SELECTION_SENSE_ENABLED" Boolean
"_TRAVERSAL_WRAP_ENABLED" Boolean
"_VERTICAL_GRID_ENABLED" Boolean
"_VISIBLE" Boolean
23.1.4 Predefined Methods GUID-118B8190-4A59-4639-8CB5-0759B5C5D41B v1
Name Type
"_GET_CELL_TEXT" Text
"_SCROLL_POSITION_INTO_VIEW" No return value
"_SCROLL_SELECTION_INTO_VIEW" No return value
"_SET_CELL_TEXT" No return value
"_SET_CELL_TEXT_RANGE" No return value
"_SET_COLUMN_WIDTH" No return value
"_SET_ROW_HEIGHT" No return value

Visual SCIL Objects
VS_LIST
23.2 Details GUID-DE12045B-7F8F-457C-9347-A23D3084AF7F v1
23.2.1 Action Attributes GUID-6D121012-E800-4BFF-81B0-1F772BCDB38F v1
_DOUBLE_CLICK
Example:
.SET MY_LIST._DOUBLE_CLICK = (“ROOT.OPEN_EDIT_DIALOG“, ““)
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_LIST
23.2.2 Action Methods GUID-74B4E3A5-3FDC-47A3-8581-6C4EEC99CA32 v1
DOUBLE_CLICK
The DOUBLE_CLICK program is run whenever the user double-clicks an item in a list. When a
double-click occurs, the user can find out which row was clicked with the _SELECTED_ROW
attribute.
GET_TABLE_EDIT_TEXT
GET_TABLE_VIEW_TEXT
This action method is executed whenever a table needs the value for a view object of the current cell.
For example, this method is executed when the view object is drawn into the cell. This function can
be used, for example, to convert edit object value of the cell to the text value of the cell.
NOTIFY
TOOLTIP_IS_SHOWN
convert the text value of a cell to the current value of the view object, which is shown in the view
the cell.

Visual SCIL Objects
VS_LIST
23.2.3 Predefined Attributes GUID-F7FA64F3-2959-4149-B102-405DA4029987 v1
_ATTRIBUTE_NAMES
Specifies whether or not a list automatically scrolls when the user drags the mouse outside of the
area currently visible in the list.

Data type: Boolean
Default value: TRUE
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_DRAWING_SELECTION_ENABLED
Specifies whether the drawing selection is used or not. If _DRAWING_SELECTION_ENABLED is set
to TRUE, all the list cells that are under the cursor when dragging the mouse become selected. If
_DRAWING_SELECTION_ENABLED is set to FALSE, the selected area is rectangular.

Data type: Boolean
Example:
.SET MY_LIST._DRAWING_SELECTION_ENABLED = TRUE

Visual SCIL Objects
VS_LIST
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_EXTEND_COLUMN_SELECTION_ENABLED
When this attribute is set to TRUE, the entire column will be selected when any of the cells in the
column is selected. The _SELECTION_POLICY attribute works as before, except that it operates on
columns instead of single cells when this attribute is set to TRUE. Only one column can be selected
when _SELECTION_POLICY is ONE_ONLY_SELECTION.

Data type: Boolean
Example:
.SET MY_LIST._EXTEND_COLUMN_SELECTION_ENABLED = TRUE
_EXTEND_ROW_SELECTION_ENABLED
When this attribute is set to TRUE, the entire row will be selected when any of the cells in the row is
selected. The SELECTION_POLICY attribute works as before except, that it operates on rows
instead of single cells when this attribute is set to TRUE. Only one row can be selected when
SELECTION_POLICY is ONE_ONLY_SELECTION.

Data type: Boolean
Example:
.SET MY_LIST._EXTEND_ROW_SELECTION_ENABLED = TRUE
_FILE_REVISION
_FIRST_VISIBLE_COLUMN
Contains the index of the leftmost visible column.

Visual SCIL Objects
VS_LIST
Description: An integer from 1 to the length of a SCIL vector.

Data type: Integer
Default value: 1
Access: Read-only
_FIRST_VISIBLE_ROW
Contains the index of the topmost visible row.

Data type: Integer
Default value: 1
Access: Read-only
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:

Visual SCIL Objects
VS_LIST
_GEOMETRY
Example:
view as if the user grabbed it, so that the scrolling of the view and the movement of the mouse are
synchronous.

Data type: Boolean
_HAS_BORDER

Data type: Boolean
Default value: TRUE
Example:
_HORIZONTAL_GRID_ENABLED
Specifies whether the horizontal grid is enabled or not.

Data type: Boolean

Data type: Boolean

Visual SCIL Objects
VS_LIST
_KEYBOARD_SELECTION_ENABLED
If set to TRUE, this attribute specifies whether an object allows keyboard selection through the
keyboard focus. This means, for example, that when a list has focus and a key is pressed, the
selected cell of the list changes to the first one that starts with the character pressed.

Data type: Boolean
Default value: TRUE
_KEYBOARD_TRAVERSAL_ENABLED
Specifies if keyboard traversal is used in list elements or not. If the value is TRUE, the object
responds to keyboard commands. In this case, the user can make selections or change focused cell
with keyboard arrow keys. If value is FALSE, the object will only handle the mouse events. In this
case, the user can make selections or change focused cell only with mouse.

Data type: Boolean
Default value: TRUE
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
the object.

Example:
_ROW_COUNT
Specifies the number of rows in a list. Note that setting this attribute to zero clears the list.

Visual SCIL Objects
VS_LIST

Data type: Integer
Default value: 0
Example:
.SET MY_LIST._ROW_COUNT = 0
_SCIL_GEOMETRY
_SELECTED_CELLS
Specifies the selected cells in a list. Note that if attribute _SELECTION_POLICY is set to
ONE_ONLY_SELECTION, only one cell can be selected at a time. Note also, that setting this
attribute does not give a SCIL error, if one or several of the specified cells are out of range, but the
values that are out of range are ignored.
Description: A vector containing zero or more items. The items are

vectors containing two integer items.
Data type: Integer
Example:
.SET MY_LIST._SELECTED_CELLS = ((1, 1), (1, 2), (1, 3))
_SELECTED_ROW
Specifies the number of selected row.

Data type: Integer
Default value: 0
Example:
@ROW = MY_LIST._SELECTED_ROW
_SELECTION_POLICY
Specifies the selection policy in a list.

FREE_SELECTION, ONE_ONLY_SELECTION,
RECTANGULAR_SELECTION and NO_SELECTION.
Data type: Text
Default value: "ONE_ONLY_SELECTION"

Visual SCIL Objects
VS_LIST
_SELECTION_SENSE_ENABLED
If _SELECTION_SENSE_ENABLED is TRUE and the user adjust-clicks on selected cells, the cells
are removed from the selection. When _SELECTION_SENSE_ENABLED is FALSE , clicking with
the mouse only adds cells to the selection. Note that the implementation of adjust-click may vary
between platforms. On the Windows platform, adjust-click is implemented as CTRL+left mouse
button.

Data type: Boolean
Default value: TRUE
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text
Example:
_TRAVERSAL_WRAP_ENABLED
Specifies whether the content of the list wraps around or not.

Data type: Boolean
_VARIABLE_NAMES
_VERTICAL_GRID_ENABLED
Specifies whether the vertical grid is enabled or not.

Data type: Boolean

Visual SCIL Objects
VS_LIST

Data type: Boolean
Default value: TRUE
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
23.2.4 Predefined Methods GUID-3E0E9362-3F1C-47A3-A7CF-E12A77497DDA v1
_FLAG_FOR_EXECUTION
_GET_CELL_TEXT
Gets the text from a given cell in the list.

Parameter(s)
ROW Integer
An integer from 1 to the length of a SCIL vector.
COLUMN Integer
Example:
@TEXT = MY_LIST._GET_CELL_TEXT(1, 1)
_GET_CELL_TEXT_RANGE
Returns the text vector ranging from the given cell in the list. The text area can be fetched
horizontally or vertically.

Visual SCIL Objects
VS_LIST
Parameter(s)
ROW Integer
COLUMN Integer
DIRECTION Text
LENGTH Integer
An integer value.
Example:
@VECTOR = MY_LIST._GET_CELL_TEXT_RANGE(1, 1, “HORIZONTAL“, 10)
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_SCROLL_POSITION_INTO_VIEW
Scrolls a list so that the specified cell is at least partly visible.

Parameter(s)
ROW Integer
COLUMN Integer
_SCROLL_SELECTION_INTO_VIEW
Scrolls a list so that the selection is displayed in the view.
_SET_CELL_TEXT
Sets the text of a given cell in the list. The list is automatically expanded if the text is set into a row or
a column that does not exist.

Visual SCIL Objects
VS_LIST

Parameter(s)
ROW Integer
COLUMN Integer
TEXT Text
Example:
MY_LIST._SET_CELL_TEXT(1, 1, “Inserted Text“)
_SET_CELL_TEXT_RANGE
Sets the text area ranging from the given cell in the list. The text area can be set horizontally or
vertically. The list is automatically expanded if the text area is set into a row or acolumn that does not
exist. The list can be cleared by setting the attribute _ROW_COUNT to zero.

Parameter(s)
ROW Integer
COLUMN Integer
DIRECTION Text
Example:
MY_LIST._SET_CELL_TEXT_RANGE(1, 1, “HORIZONTAL“, %VECTOR)
_SET_COLUMN_WIDTH
Sets the width of a specified column.

Parameter(s)
COLUMN Integer
WIDTH Integer
An integer value.
Example:
MY_LIST._SET_COLUMN_WIDTH(1, 80)
_SET_ROW_HEIGHT
Sets the height of a specified row.

Visual SCIL Objects
VS_LIST

Parameter(s)
ROW Integer
HEIGHT Integer
An integer value.
Example:
MY_LIST._SET_ROW_HEIGHT(1, 25)

Visual SCIL Objects
242
VS_MAIN_DIALOG
Section 24 VS_MAIN_DIALOG GUID-41AD2E97-F1B8-4A82-8543-71BE4DDC1187 v1
24.1 Overview GUID-49E16960-8971-415C-84D3-4FE7396941C0 v1
The main dialog should be used as the root object for independent dialogs or tools that must not
interfere with the SCIL context of the parent object. A VS_MAIN_DIALOG works like a VS_DIALOG
except that it is used as a barrier object between the SCIL context of the containing dialog/picture
and the VS_MAIN_DIALOG with all its contents. It also works as a wall in the object visibility space.
24.1.1 Action Attributes GUID-9B01C40D-6C2B-4124-9AED-40505AA196D5 v1
Name Type
"_ARRANGE_NOTIFY" Text vector
24.1.2 Action Methods GUID-A3DA0D7E-8BE7-4EBD-BA22-257E49AA4445 v1
Name Type
"ARRANGE_NOTIFY" No return value
24.1.3 Predefined Attributes GUID-0B934AE3-9743-4E2B-A41F-49B6510D14A8 v1
Name Type
"_BUSY" Boolean
"_CLIPBOARD_HAS_CONTENTS" Boolean
"_CLIPBOARD_TEXT" Vector
"_COPY_LOGICALS" Boolean
"_DEFAULT_PATH" Text

Visual SCIL Objects
VS_MAIN_DIALOG
"_FONT" Font
"_GEOMETRY" List
"_MODAL" Boolean
"_OBJECT_NAME" Text
"_OPEN" Boolean
"_STYLE" Vector
"_TITLE" Text
24.1.4 Predefined Methods GUID-B7E6091A-CE26-4A25-A3A1-32BB1827323B v1
Name Type
"_PRINT" No return value

Visual SCIL Objects
VS_MAIN_DIALOG
24.2 Details GUID-AE63D504-EAE9-41A8-902D-6644B5760384 v1
24.2.1 Action Attributes GUID-C0FC6736-7C9B-4E67-A976-E327C8B669E5 v1
_ARRANGE_NOTIFY
Setting this attribute specifies the action method ARRANGE_NOTIFY.
_CLOSE_NOTIFY
Example:
_GOT_FOCUS_NOTIFY
_KEY_PRESSED
_LOST_FOCUS_NOTIFY
_NOTIFY
24.2.2 Action Methods GUID-478BD45D-D70F-4DBC-BFA3-E4547F4B241A v2
ARRANGE_NOTIFY
This action method is executed when the size of a dialog is changed with the mouse and the button
is released.
CLOSE_NOTIFY
The CLOSE_NOTIFY action method is called immediately after the user closes a dialog. It is called
before the dialog is actually closed. If the method returns TRUE, the dialog is not closed. If it returns
FALSE, the dialog is closed normally. Note that the CLOSE_NOTIFY action method is not always
run. For example, it is not run when a dialog is deleted or closed programmatically. Normal cleaning
up after a dialog should be done in the DELETE method of the dialog and not in the CLOSE_NOTIFY
method.

Visual SCIL Objects
VS_MAIN_DIALOG
GOT_FOCUS_NOTIFY
This action method is executed immediately after the dialog has got input focus.
KEY_PRESSED
This action method is executed after a key or key combination is pressed in the dialog which has
Below are text representations for Key argument:
• one letter from A to Z, case insensitive (ordinary alphabet keys)

• one number from 0 to 9 (numeric keys)
• Left, Right, Up and Down arrow keys
• HOME, END, PageUp, PageDown, INSERT, DELETE, TAB, ENTER, Backspace, ESC
(corresponding keys, case insensitive)
• F1...F12 with the exception of F3 (this key is used to print the dialog which has focus).
The following key combinations are system reserved and do not activate the action
method: CTRL+ALT+DEL, ALT+TAB, ALT+ENTER, ALT+ESC, CTRL+ESC.
LOST_FOCUS_NOTIFY
This action method is executed immediately after a dialog has lost input focus.
NOTIFY
Specifies the notification procedure of an object. The notification procedure gets called for different
specific object.
24.2.3 Predefined Attributes GUID-10FE720D-4D30-4D34-82FA-AC6D1FA4251B v1
_ABANDON_ITEM
Specifies which dialog item is the abandon item. The NOTIFY action method of the abandon item is
executed when the user presses the abandon key. The meaning of the abandon key depends on the
current look-and-feel. On Microsoft Windows, the abandon key is Escape (ESC).

Example:

Visual SCIL Objects
VS_MAIN_DIALOG
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
_BUSY

Data type: Boolean
_CHILD_OBJECTS
_CLIPBOARD_HAS_CONTENTS
This attribute can be used to check if the clipboard has contents in text format that can be used from
SCIL. The related attribute _CLIPBOARD_TEXT can be used to read or write the contents of the
system clipboard on platforms that support the clipboard concept.

Data type: Boolean
Access: Read-only
_CLIPBOARD_TEXT
This attribute can be used to read and write the contents of the system clipboard on platforms that
support the clipboard concept. The related attribute _CLIPBOARD_HAS_CONTENTS can be used to
check if the clipboard has contents in text format that can be used from SCIL.

Data type: Vector
_CONFIRM_ITEM
executed when the user presses the confirm key. The meaning of the confirm key depends on the

Visual SCIL Objects
VS_MAIN_DIALOG

Example:
_COPY_LOGICALS
A boolean value that defines whether temporary logical paths and representation libraries of the
creating context are copied to the context of the created main dialog or not. Temporary logical paths
and representation libraries are those that are defined using the “+“ sign (#path my_path +/sc/apl/
test/my_pict). The default value for this attribute is FALSE.

Data type: Boolean
_DEFAULT_FOCUS_ITEM
Specifies which dialog item should receive keyboard focus when a dialog receives keyboard focus.

Example:
_DEFAULT_PATH
Defines the path definition to be used when no logical path is used in file and library representation
references within the main dialog context. If not specifies, the default path is inherited from the parent
object.

Data type: Text
Default value: Default path of creating object
_FILE_REVISION

Visual SCIL Objects
VS_MAIN_DIALOG
_FOCUS_ITEM

Example:
_FOCUSABLE
dependent on the window system, and this function only indicates that the window has use for key

Data type: Boolean
Default value: TRUE
_FONT
_FOREGROUND_COLOR
_GEOMETRY
_ICON
reference.

Example:

Visual SCIL Objects
VS_MAIN_DIALOG
_ICONIFIED

Data type: Boolean
_ITEM_COUNT
Specifies the number of dialog items in a dialog. This attribute specifies the number of dialog items
added directly to a dialog. Since certain dialog items may contain others (for example containers),
the total number of dialog items in the dialog may be larger.

Data type: Integer
Default value: 0
Access: Read-only
Example:
@NUMBER_OF_DIALOG_ITEMS = MY_DIALOG._ITEM_COUNT
_LEADER_DIALOG
iconified, uniconified, blocked, or unblocked, any follower dialog receive the same message as a side
effect. The exact implications of this designation are window system dependent. Typically, dialogs
with the same leader are placed in a group by the window system. If either dialog is destroyed, the
other dialog's reference to it is deleted automatically. The _LEADER_DIALOG attribute of a dialog
must be set before the dialog is opened.
are inherited.

Access: Write-only
_LEADER_DIALOG_ITEM

dialog for the given window. The leader dialog is the one that holds the item specified. For more
information about leader-follower dialogs relationship, see the description of the _LEADER_DIALOG
attribute. Setting this attribute to empty text unsets the leader dialog for the given window.
This attribute can be used, for example, in a picture methods for setting picture container as the
leader dialog item. This is only way to raise a new dialog from a picture context and set the picture

Visual SCIL Objects
VS_MAIN_DIALOG
context.
Example:
_MAX_HEIGHT
_MAX_WIDTH
_MAXIMIZED

Data type: Boolean
_MIN_HEIGHT
FFor more information, see Section 3.
_MIN_WIDTH
_MODAL

Data type: Boolean
_OBJECT_CLASS
_OBJECT_NAME

Visual SCIL Objects
VS_MAIN_DIALOG
_OPEN
size on the display. Setting the attribute to FALSE closes the window but does not delete it.

Data type: Boolean
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_STYLE

STYLE_BACKGROUND
Unclosable icons.
STYLE_DOCUMENT

Visual SCIL Objects
VS_MAIN_DIALOG

Data type: Vector
"STYLE_RESIZABLE")
_TITLE
Specifies the title of a window. Note that the title may not be visible under certain circumstances, for
example if the window or dialog does not have a title bar.

Data type: Text
_VARIABLE_NAMES
24.2.4 Predefined Methods GUID-74050C17-5AD7-4DB9-A67B-4BCE480CBA71 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_ITEM_INDEX
Returns the item index of a dialog item inside the dialog. The item index specifies the tabbing and
drawing order between dialog items inside a dialog.

Parameter(s)
ITEM Dialog Item

Visual SCIL Objects
VS_MAIN_DIALOG
_GET_POINTER_POS
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_PLACE
PLACE_BOTTOM.

Visual SCIL Objects
VS_MAIN_DIALOG

Parameter(s)
X_FLAGS Vector
Y_FLAGS Vector
Example:

(“PLACE_TOP“,
“PLACE_ALIGN“))
Positions a dialog's relative place compared to the given rectangle in the coordinate system of a


Visual SCIL Objects
VS_MAIN_DIALOG

Parameter(s)
BASE Dialog Item
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:


Positions a dialog's relative place compared to a given rectangle. The RECT parameter specifies the
PLACE_BOTTOM.

Visual SCIL Objects
VS_MAIN_DIALOG

Parameter(s)
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
Positions a dialog's relative place compared to a given SCIL rectangle. The RECT parameter

Visual SCIL Objects
VS_MAIN_DIALOG

Parameter(s)
RECT List
X_FLAGS Vector
Y_FLAGS Vector
Example:
_PRINT
Prints the content of a dialog on the default printer. Note that overlapping windows which are located
inside the dialog are printed, too.
_RAISE
_SET_ITEM_INDEX
Specifies the item index of a dialog item inside the dialog. The item index specifies the tabbing and
drawing order between the dialog items inside a dialog.

Visual SCIL Objects
VS_MAIN_DIALOG

Parameter(s)
ITEM Dialog Item
INDEX Integer
An integer value.
_SET_MAX_SIZE
_SET_MIN_SIZE

Visual SCIL Objects
260
VS_MENU
Section 25 VS_MENU GUID-8492014A-622F-4C55-AE27-15F021B50533 v1
25.1 Overview GUID-8081EE5E-7020-4576-886B-890DAB9C7888 v1
Contains the information needed to represent a single menu. Each VS_MENU contains an array of
menu items, each of which represent an individual command. The parent of a VS_MENU is a
VS_MENUBAR or a VS_SUB_MENU_ITEM in a hierarchical menu scheme. VS_MENUs including
its parent the VS_MENUBAR and possible sub-menus can be created either dynamically or by using
the dialog editor.
25.1.1 Action Attributes GUID-6E137778-C244-4043-B31B-6263F968F920 v1
Name Type
"_OPEN_NOTIFY" Text vector
25.1.2 Action Methods GUID-31CDDBA5-9A7C-4E8A-AE59-78C7499F0F38 v1
Name Type
"OPEN_NOTIFY" No return value
25.1.3 Predefined Attributes GUID-42EF3EDC-2EAF-472F-AD20-FD3B6213F40E v1
Name Type
"_ENABLED" Boolean
"_FONT" Font
"_MNEMONIC" Text
"_OBJECT_NAME" Text
"_TITLE" Text
25.1.4 Predefined Methods GUID-A0D4736D-208F-49E8-B4EC-22D36AE9A797 v1
Name Type

Visual SCIL Objects
VS_MENU
25.2 Details GUID-B5E41B8C-C621-4C50-BF3A-27DF4828762D v1
25.2.1 Action Attributes GUID-3430D3D3-172F-4FAE-802A-E9A52A857404 v1
_OPEN_NOTIFY
Setting this attribute specifies the action method OPEN_NOTIFY.
25.2.2 Action Methods GUID-24DC6E77-9D89-4B19-B3A6-BF3B4D1DF85A v1
OPEN_NOTIFY
This action method is executed just before the menu is opened and drawn to a window. This action
mehod can be used to change the properties of the VS_MENU.
25.2.3 Predefined Attributes GUID-31AAE14C-B6A4-4CB7-91D4-A9AC50B74A76 v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
_CHILD_OBJECTS
_ENABLED
Specifies whether a menu is enabled or not. A change of appearance is also often combined with this
attribute. On the Windows platform, the menu is dimmed when this attribute is set to TRUE.

Data type: Boolean
Default value: TRUE
_FILE_REVISION
_FONT
_FOREGROUND_COLOR

Visual SCIL Objects
VS_MENU
_ITEM_COUNT
Contains the number of menu items appended to a menu.

Data type: Integer
Default value: 0
Access: Read-only
_MNEMONIC
Specifies the mnemonic character of a menu. A change of appearance is also often combined with
this attribute. In Windows platform, the setting of this attribute underlines the mnemonic character in
the menu.

Data type: Text
_OBJECT_CLASS
_OBJECT_NAME
_SOURCE_FILE_NAME
_TITLE

Data type: Text
_VARIABLE_NAMES
25.2.4 Predefined Methods GUID-66B6E5C5-954A-42DB-9A4D-56FCF7117145 v1
_FLAG_FOR_EXECUTION
_GET_HELP

Visual SCIL Objects
VS_MENU
_GET_STRING_WIDTH
Returns the width of the given string in the current font of the object.spotify:user:1123248529

Parameter(s)
STRING Text
Positions a dialog's relative place compared to a given rectangle in the coordinate system of a dialog


Parameter(s)
BASE Dialog Item

Visual SCIL Objects
VS_MENU
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:



Visual SCIL Objects
266
VS_MENU_ITEM
Section 26 VS_MENU_ITEM GUID-E22C9BDF-CBDE-441F-832D-E0CC80ED4894 v1
26.1 Overview GUID-2D041CD4-3883-4C03-9418-87CF2FA1EA64 v1
Contains the information needed to represent a single menu item. Each menu contains an array of
MENU_ITEMs, each of which represent an individual command. A MENU_ITEM is a horizontal
section of a menu. The parent of a MENU_ITEM is a MENU. MENUs including MENU_ITEMs, the
MENUBAR and possible sub-menus can be created dynamically or using the Dialog Editor. The
NOTIFY action method is called whenever the menu item is selected, either with the mouse or using
mnemonic or accelerator keys. Accelerator keys are shortcuts to select the menu item using
keyboard e.g. CTRL+S for Save menu item.
26.1.1 Action Attributes GUID-3720F652-65D5-46E3-921E-1F2E25EE2847 v1
Name Type
26.1.2 Action Methods GUID-7638EAE5-FEFD-4497-B060-732A4E2F31D6 v1
Name Type
26.1.3 Predefined Attributes GUID-FE2D651A-6227-47C5-A624-4A8197D530B6 v1
Name Type
"_ENABLED" Boolean
"_FONT" Font
"_MNEMONIC" Text
"_OBJECT_NAME" Text
"_TITLE" Text
26.1.4 Predefined Methods GUID-B6C853D0-28B5-4383-9662-D21AD7B0EE90 v1
Name Type
"_SET_ACCELERATOR_KEY" No return value

Visual SCIL Objects
VS_MENU_ITEM
26.2 Details GUID-C2A17B98-7E57-464B-8A59-27872C0C694C v1
26.2.1 Action Attributes GUID-A570BB77-F8BE-47F5-A6F8-6BB925FEABEF v1
_NOTIFY
26.2.2 Action Methods GUID-5BF873EC-FDB6-4747-A22B-915599E8A3AD v1
NOTIFY
Specifies the NOTIFY action method for a menu item. This is executed when a menu item is
selected.
26.2.3 Predefined Attributes GUID-2121BE4D-7759-45CE-ADA9-F0AAA7A298C1 v1
_ATTRIBUTE_NAMES
_CHILD_OBJECTS
_ENABLED
Specifies whether the menu item is enabled or not. Changing this attribute also affects the
appearance of the menu item.

Data type: Boolean
Default value: TRUE
_FILE_REVISION
_FONT
_FOREGROUND_COLOR
_IMAGE
Specifies an image that is associated with an object. The way the image is displayed depends on the
object. The image is given as an object reference to the image that has been loaded or created as an
independent object.

Visual SCIL Objects
VS_MENU_ITEM

using the function .LOAD. Size of the image should be of
16 % 16 preferably.
Example:
.LOAD ROOT\ IMAGE1 = VS_IMAGE("...
.SET ROOT\ MY_MENU_ITEM._IMAGE = "ROOT\ IMAGE1"
_MNEMONIC
Specifies the mnemonic character of a menu item. A change of appearance is also often combined
with this attribute. In Microsoft Windows platform, the setting of this attribute underlines the
mnemonic character in the menu item.

Data type: Text
_OBJECT_CLASS
_OBJECT_NAME
_SOURCE_FILE_NAME
_TITLE
Specifies the title of a menu item.

Data type: Text
_VARIABLE_NAMES
26.2.4 Predefined Methods GUID-2C92016C-7FE6-4298-903C-A626244454E8 v2
_FLAG_FOR_EXECUTION

Visual SCIL Objects
VS_MENU_ITEM
_GET_HELP
_SET_ACCELERATOR_KEY
This method can be used to set accelerator keys for a menu item.
The first argument (Key) may have one of the following text representations:
• one letter from A to Z (case insensitive, ordinary alphabet keys)

• one number from 0 to 9
• Left, Right, Up, Down arrow keys, case insensitive.
• HOME, END, PageUp, PageDown, INSERT, DELETE, TAB, ENTER, Backspace, ESC
(corresponding keys, case insensitive)
• F1...F12 with the exception of F3 (this key is used to print the dialog which has focus).
The following key combinations are system reserved and should not be overriden:
CTRL+ALT+DEL, ALT+TAB, ALT+ENTER, ALT+ESC, CTRL+ESC.

Parameter(s)
KEY Text A character string containing up to
255 characters.
ALT_ENABLED Boolean A value of TRUE or FALSE.
CTRL_ENABLED Boolean A value of TRUE or FALSE.
SHIFT_ENABLED Boolean A value of TRUE or FALSE.
Example:
ROOT\\MITEM._SET_ACCELERATOR_KEY(“F5“, FALSE, TRUE, FALSE)

Visual SCIL Objects
VS_MENUBAR
Section 27 VS_MENUBAR GUID-B266A732-6AAC-4AFB-A6C8-67A3DFDE007A v1
27.1 Overview GUID-4A63EF99-6772-4096-BE72-A80FE384A3F5 v1
Contains the information needed to represent a single menubar. A VS_MENUBAR contains an

ordered list of VS_MENUs. A menubar displays the title for each of its menus. Clicking or key
traversing a title opens the associated menu. A VS_MENUBAR must be placed in a VS_DIALOG or
VS_MAIN_DIALOG. VS_MENUBARs including its VS_MENUs can be created either dynamically or
by using the dialog editor.
27.1.1 Action Attributes GUID-50EAE832-5E08-4B5F-BC24-57755694F3E0 v1
Name Type
27.1.2 Action Methods GUID-F3275DD9-1043-46D3-AD55-5D3BAADF9127 v1
Name Type
27.1.3 Predefined Attributes GUID-B773AB08-2D03-421F-B5DD-9BE037AED411 v1
Name Type
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_HAS_HELP" Boolean
"_MENU_COUNT" Integer
"_OBJECT_NAME" Text
"_TITLE" Text
"_VISIBLE" Boolean

Visual SCIL Objects
VS_MENUBAR
27.1.4 Predefined Methods GUID-E2C1F0FC-4CD2-46FB-A01E-0F76A4598363 v1
Name Type
27.2 Details GUID-B829E3E1-DC85-40C9-919E-74BC0DE96C88 v1
27.2.1 Action Attributes GUID-CE878EEE-7CFC-4564-B5B1-773E439E94B7 v1
_TOOLTIP_IS_SHOWN
27.2.2 Action Methods GUID-E8664C93-D471-4C4D-A973-066374F32CD7 v1
TOOLTIP_IS_SHOWN
27.2.3 Predefined Attributes GUID-78FFE370-A5C4-415C-92BA-CBC65E868402 v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_ENABLED

Visual SCIL Objects
VS_MENUBAR

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_HAS_HELP
Specifies whether the last menu on the menu bar is a help menu or not. This has to be specified
because the help menu may be treated differently than ordinary menus on some platforms.

Visual SCIL Objects
VS_MENUBAR

Data type: Boolean
_MENU_COUNT
Specifies the number of top-level menus appended to a menu bar.

Data type: Integer
Default value: 0
Access: Read-only
_OBJECT_CLASS
_OBJECT_NAME
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TITLE

Data type: Text
Example:
_TOOLTIP_TEXT
Data type: Text
Example:
_VARIABLE_NAMES

Visual SCIL Objects
VS_MENUBAR
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
27.2.4 Predefined Methods GUID-32E8E366-D948-4A1C-814F-AFD2F7B49A7D v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text

Visual SCIL Objects
276
VS_NOTEBOOK
Section 28 VS_NOTEBOOK GUID-228E4D58-5E4F-4BF9-803A-D4ECE68A75DC v1
28.1 Overview GUID-43895312-74B6-4587-B3BF-D4E80C76AD79 v1
A notebook item resembles a real notebook in appearance and performance. It contains one or more
pages (VS_NOTEBOOK_PAGE), each of which contains dialog items that the user can view or edit.
Only one page (the active page) is visible at a time. The remaining pages are stacked behind the
active page. The NOTIFY action method is called every time a new page is appended or selected. If
pages are appended to the notebook dynamically, the first page of the notebook is always selected
as default.
28.1.1 Action Attributes GUID-8D7EC8B6-A767-44DF-8A54-7D933CC02F44 v1
Name Type
28.1.2 Action Methods GUID-A7219A99-C0DA-4150-8A76-7B0E4FB698B7 v1
Name Type
28.1.3 Predefined Attributes GUID-3EF5DEF7-23A0-4AF9-81FF-AF1219931AE5 v1
Name Type
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_OBJECT_NAME" Text
"_PAGE_COUNT" Integer
"_SELECTED_PAGE_INDEX" Integer

Visual SCIL Objects
VS_NOTEBOOK
"_VISIBLE" Boolean
28.1.4 Predefined Methods GUID-D1C225C5-FD2E-4EC2-B6C3-1B439B33B0EE v1
Name Type
28.2 Details GUID-362F4523-1682-4502-ABAB-5AC1F618C9F7 v1
28.2.1 Action Attributes GUID-89CCEF9D-E2DA-404E-8891-B60FA99D63B5 v1
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN
28.2.2 Action Methods GUID-B94909A5-0F10-4068-A197-65EFEEE183C4 v1
NOTIFY
TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_NOTEBOOK
28.2.3 Predefined Attributes GUID-268D6329-31B1-4D8B-B0DE-F163FB367FCE v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Visual SCIL Objects
VS_NOTEBOOK

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED
Contains the value TRUE if a dialog item has keyboard focus.

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_OBJECT_CLASS
_OBJECT_NAME
_PAGE_COUNT
Specifies the number of notebook pages attached into a notebook.

Visual SCIL Objects
VS_NOTEBOOK

Data type: Integer
Default value: 0
Access: Read-only
_POP_UP_MENU
Specifies the popup menu that is associated with an object. This menu is activated by right-clicking
the object.

Example:
_SCIL_GEOMETRY
_SELECTED_PAGE_INDEX
Specifies the page in the notebook that is selected.
Description: An integer greater than 0.

Data type: Integer
Example:
.SET MY_NOTEBOOK._SELECTED_PAGE_INDEX=3
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text
Example:
_VARIABLE_NAMES

Visual SCIL Objects
VS_NOTEBOOK
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
28.2.4 Predefined Methods GUID-0E24AF93-1789-4261-8A95-48A0983D620A v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text

Visual SCIL Objects
VS_NOTEBOOK_PAGE
Section 29 VS_NOTEBOOK_PAGE GUID-7ED9D885-DCBC-4BC1-B529-0ED31168856A v1
29.1 Overview GUID-1A23B85A-7CC7-46D2-B471-0871B7A7446E v1
A VS_NOTEBOOK_PAGE is a page of a VS_NOTEBOOK that can contain dialog items the same
way as containers and dialogs. Only one page (the active page) is visible at a time.
29.1.1 Action Attributes GUID-AE0CB82A-6A84-4FBC-A3CA-D060FA3AAA00 v1
Name Type
Section 29.2.1 Text Vector
"_PAGE_SELECTED" Text vector
29.1.2 Action Methods GUID-5C260650-A280-450F-87E7-F2F654E21508 v1
Name Type
"PAGE_SELECTED" No return value
29.1.3 Predefined Attributes GUID-2065FC33-A611-4057-8269-CEAC1C5CA2A5 v1
Name Type
"_ENABLED" Boolean
"_FLAT_KEYBOARD_TRAVERSAL_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_OBJECT_NAME" Text
"_SELECTABLE" Boolean

Visual SCIL Objects
VS_NOTEBOOK_PAGE
"_SELECTED" Boolean
"_TITLE" Text
"_VISIBLE" Boolean
29.1.4 Predefined Methods GUID-F420FB7A-1977-4D7C-AFC0-6805721B80A8 v1
Name Type
"_SELECT" No return value
29.2 Details GUID-B889EB81-4D7A-41C8-B857-693E92B6F6A4 v1
29.2.1 Action Attributes GUID-A418B27B-97C1-4F6E-822D-8E9D5966BE79 v1
_NOTIFY
Setting of this attribute specifies the action method NOTIFY.
Example:
_PAGE_SELECTED
Setting this attribute specifies the action method PAGE_SELECTED.
_TOOLTIP_IS_SHOWN
29.2.2 Action Methods GUID-3CE2E7E8-A818-4180-9298-68DD0D7C98FD v1
NOTIFY

Visual SCIL Objects
VS_NOTEBOOK_PAGE
PAGE_SELECTED
The PAGE_SELECTED program is run whenever the user selects a notebook page. The notebook
page can be selected programmatically by the method _SELECT.
TOOLTIP_IS_SHOWN
29.2.3 Predefined Attributes GUID-0881611A-133F-4061-8A00-630397350F22 v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_DEFAULT_FOCUS_ITEM
Specified which dialog item should receive keyboard focus when the container receives keyboard
focus.

Example:

Visual SCIL Objects
VS_NOTEBOOK_PAGE
.SET MY_CONTAINER._DEFAULT_FOCUS_ITEM = “MY_LIST“
_ENABLED
Specifies whether the VS_NOTEBOOK_PAGE item responds to various events. A change of
appearance is also often combined with this attribute. When setting this attribute to FALSE, the
disabled VS_NOTEOOOK_PAGE is displayed as dimmed and it cannot be activated with the
keyboard or the mouse.

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FLAT_KEYBOARD_TRAVERSAL_ENABLED
Specifies that the container does not interfere with the traversal of the objects in the dialog (for
example when using the TAB key to move from object to object). When
_FLAT_KEYBOARD_TRAVERSAL_ENABLED is TRUE, the objects appear to be on the same level
although they are within a container. The appearance of the container is also different depending on
this attribute.

Data type: Boolean
Example:
.SET MY_CONTAINER._FLAT_KEYBOARD_TRAVERSAL_ENABLED = TRUE
_FOCUS_ITEM
Changes the current keyboard focus of the VS_NOTEBOOK_PAGE to a specified dialog item. The
dialog item that has keyboard focus receives all normal keystrokes and certain function keys. If the
object is open, the appearance may change to indicate which item has focus. For some look-and-
feels, the dashed line is drawn around the objects label. Note that the focus item is cleared whenever
this page is selected.

Example:
.SET MY_CONTAINER._FOCUS_ITEM = “MY_OK_BUTTON“

Visual SCIL Objects
VS_NOTEBOOK_PAGE
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED
Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_ITEM_COUNT
Specifies the number of dialog items in an object. This attribute specifies the number of dialog items
added directly into the object. Since certain dialog items may contain others (for example containers),

Visual SCIL Objects
VS_NOTEBOOK_PAGE

Data type: Integer
Default value: 0
Access: Read-only
Example:
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
the object.

Example:
_SCIL_GEOMETRY
_SELECTABLE
Specifies whether the user can select a notebook page. The programmer must make sure that the
first page that is displayed is selectable.

Data type: Boolean
_SELECTED
Indicates whether or not a page is currently the selected page of a notebook. A page in the notebook
is selected programmatically using the predefined method _SELECT.

Visual SCIL Objects
VS_NOTEBOOK_PAGE

Data type: Boolean
Access: Read-only
_SOURCE_FILE_NAME
_TITLE

Data type: Text
Example:
_TOOLTIP_TEXT
Data type: Text
Example:
_VARIABLE_NAMES
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
29.2.4 Predefined Methods GUID-293F50AD-824D-44CA-BB34-7E3AA7473909 v1
_FLAG_FOR_EXECUTION

Visual SCIL Objects
VS_NOTEBOOK_PAGE
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_SELECT
Selects a notebook page. This method is used when the object name of notebook page is known.

Visual SCIL Objects
VS_NOTICE_DIALOG
Section 30 VS_NOTICE_DIALOG GUID-9AA9DB65-F434-40EB-B647-0992810520FA v1
30.1 Overview GUID-FA5268CB-7302-4D34-9316-3BBE638CF0A3 v1
The VS_NOTICE_DIALOG is a dialog box intended to inform the user of an error or to ask the user
for confirmation. A notice dialog usually has either a single OK button or Yes and No buttons. Both
can have optional Cancel and Help buttons. The attribute _IS_CAUTION_DIALOG specifies whether
the dialog is a caution or an OK dialog. An OK dialog usually has just an OK button and a caution
dialog has Yes and No buttons. Attribute _IS_CAUTION_DIALOG has to be set before the action
methods are defined. It is possible to change the icon of the VS_NOTICE_DIALOG by setting the
attribute _NOTICE_ICON.
30.1.1 Action Attributes GUID-A535F5EE-19C2-4CFC-A7DD-766A4B607FD9 v1
Name Type
"_APPLY" Text vector
"_CANCEL" Text vector
"_DEFAULTS" Text vector
"_HELP" Text vector
"_NO" Text vector
"_OK" Text vector
"_YES" Text vector
30.1.2 Action Methods GUID-A09EF3E1-5A79-4D8F-972D-5A54FE71E56A v1
Name Type
"APPLY" Boolean
"CANCEL_HOOK" Integer
"DEFAULTS" Boolean
"HELP" Boolean
"NO_HOOK" Integer
"OK_HOOK" Integer
"YES_HOOK" Integer
30.1.3 Predefined Attributes GUID-A395441B-6566-4B96-9235-13C3F24B45AC v1
Name Type
"_APPLY_TITLE" Text

Visual SCIL Objects
VS_NOTICE_DIALOG
"_BUSY" Boolean
"_BUTTONS_VERTICALLY" Boolean
"_CANCEL_TITLE" Text
"_DEFAULTS_TITLE" Text
"_FONT" Font
"_GEOMETRY" List
"_HAS_APPLY" Boolean
"_HAS_CANCEL" Boolean
"_HAS_DEFAULTS" Boolean
"_HAS_HELP" Boolean
"_HAS_ICON" Boolean
"_HAS_OK" Boolean
"_HELP_TITLE" Text
"_IS_CAUTION_DIALOG" Boolean
"_MODAL" Boolean
"_NO_TITLE" Text
"_NOTICE_ICON" Text
"_OBJECT_NAME" Text
"_OK_TITLE" Text
"_OPEN" Boolean
"_STYLE" Vector
"_TEXT" Text
"_TITLE" Text
"_YES_TITLE" Text

Visual SCIL Objects
VS_NOTICE_DIALOG
30.1.4 Predefined Methods GUID-A40C3AD9-66BA-4D57-90AF-27C71D98D7F9 v1
Name Type
30.2 Details GUID-B0365B66-ECEA-4BD8-B772-90B744905156 v1
30.2.1 Action Attributes GUID-19631EAC-A728-4944-BB68-D52C73CE9FC6 v1
_APPLY
Setting of this attribute specifies the action method APPLY.
Example:
.SET MY_DIALOG._APPLY = (“ROOT.APPLY_DIALOG“, ““)
_CANCEL
Setting of this attribute specifies the action method CANCEL.
_CLOSE_NOTIFY
Setting of this attribute specifies the action method CLOSE_NOTIFY.
Example:
_DEFAULTS
Setting of this attribute specifies the action method DEFAULTS.
Example:
.SET MY_DIALOG._DEFAULTS = (“ROOT.DEFAULTS_DIALOG“, ““)

Visual SCIL Objects
VS_NOTICE_DIALOG
_HELP
Setting of this attribute specifies the action method HELP.
Example:
.SET MY_DIALOG._HELP = (“ROOT.HELP_DIALOG“, ““)
_NO
Setting of this attribute specifies the action method NO.
_NOTIFY
Setting of this attribute specifies the action method NOTIFY.
_OK
Setting of this attribute specifies the action method OK.
_YES
Setting of this attribute specifies the action method YES.
30.2.2 Action Methods GUID-1D376A02-6DEB-477F-ADB8-9A73158BE7EE v1
APPLY
Specifies the action method that is executed when the Apply button is clicked in the confirmation
dialog. If this action method is not set, the dialog is closed by default, when the Apply is clicked. The
dialog is automatically closed if the user returns TRUE from this action method, when the Apply is
clicked.
CANCEL_HOOK
Specifies the action method that is executed when the “Cancel“ button is pressed in the notice
dialog. If this action method is not set the default behaviour when the button is pressed is that the
dialog is closed. The dialog is automatically closed if the user returns TRUE from this action method.
Data type to be returned: Integer
CLOSE_NOTIFY
The CLOSE_NOTIFY action method is called immediately after the user chose to close the dialog. It
is called before the dialog is actually closed. If the method returns TRUE, the dialog is not closed. If it
always run. For example, it is not run when a dialog is deleted or closed programmatically. Normal

Visual SCIL Objects
VS_NOTICE_DIALOG
DEFAULTS
Specifies the action method that is executed when the “Defaults“ button is pressed in the
confirmation dialog.
HELP
Specifies the action method that is executed when the “Help“ button is pressed in the confirmation
dialog.
NO_HOOK
Specifies the action method that is executed when the “No“ button is pressed in the notice dialog. If
this action method is not set the default behaviour when the button is pressed is that the dialog is
closed. The dialog is automatically closed if the user returns TRUE from this action method.
NOTIFY
specific object.
OK_HOOK
Specifies the action method that is executed when the “OK“ button is pressed in the notice dialog. If
YES_HOOK
Specifies the action method that is executed when the “Yes“ button is pressed in the notice dialog. If
30.2.3 Predefined Attributes GUID-F73708DC-A9CD-4058-8424-329432CD0E65 v1
_ABANDON_ITEM
Specifies which dialog item that is the abandon item. The NOTIFY action method of the abandon
item is executed when the user presses the abandon key. The meaning of the abandon key depends
on current look-and-feel. On Microsoft Windows the abandon key is Escape (Esc).

Visual SCIL Objects
VS_NOTICE_DIALOG

Example:
_APPLY_TITLE
The title of the “Apply“ button can be changed by setting this attribute.

Data type: Text
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
_BUSY
window is unavailable to the user. On Windows platform the cursor is displayed as an hour glass.

Data type: Boolean
_BUTTONS_VERTICALLY
Specifies that the buttons within the confirmation dialog should be arranged vertically instead of
horizontally. The default is horizontal arrangement.

Data type: Boolean
Example:
.SET MY_DIALOG._BUTTONS_VERTICALLY = TRUE

Visual SCIL Objects
VS_NOTICE_DIALOG
_CANCEL_TITLE
The title of the “Cancel“ button can be changed by setting this attribute.

Data type: Text
_CHILD_OBJECTS
_CONFIRM_ITEM
current look-and-feel. On Microsoft Windows the confirm key is Return (Enter). The confirm item is

Example:
_DEFAULT_FOCUS_ITEM
Specifies which dialog item should receive keyboard focus when the dialog receives keyboard focus.

Example:
_DEFAULTS_TITLE
The title of the “Defaults“ button can be changed by setting this attribute.

Data type: Text

Visual SCIL Objects
VS_NOTICE_DIALOG
_FILE_REVISION
_FOCUS_ITEM

Example:
_FOCUSABLE
dependent on the window system; this function only indicates that the window has use for key
events. The window manager lets user manipulate rectangular, overlapping display regions known as
windows. Window manager windows correspond to the top-level windows of the underlying window
system (X Window System and Microsoft Windows, for example).

Data type: Boolean
Default value: TRUE
_FONT
_FOREGROUND_COLOR
_GEOMETRY
_HAS_APPLY
Specifies whether the confirmation dialog has an Apply button or not.

Data type: Boolean
Example:
.SET MY_DIALOG._HAS_APPLY = FALSE

Visual SCIL Objects
VS_NOTICE_DIALOG
_HAS_CANCEL
Specifies whether the confirmation dialog has a Cancel button or not.

Data type: Boolean
Example:
.SET MY_DIALOG._HAS_CANCEL = TRUE
_HAS_DEFAULTS
Specifies whether the confirmation dialog has a Defaults button or not.

Data type: Boolean
Example:
.SET MY_DIALOG._HAS_DEFAULTS = FALSE
_HAS_HELP

Data type: Boolean
Example:
_HAS_ICON
Specifies whether the icon is displayed or not.

Data type: Boolean
Access: Read-only
_HAS_OK
Specifies whether the confirmation dialog has an OK button or not.

Visual SCIL Objects
VS_NOTICE_DIALOG

Data type: Boolean
Example:
.SET MY_DIALOG._HAS_OK = TRUE
_HELP_TITLE
The title of the “Help“ button can be changed by setting this attribute.

Data type: Text
_ICON

Example:
_ICONIFIED
the window system and window manager in use. The window manager lets user manipulate

Data type: Boolean
_IS_CAUTION_DIALOG
Specifies whether the notice dialog is caution dialog or not. If _IS_CAUTION_DIALOG is TRUE the
notice dialog is displayed with “Yes“ and “No“ buttons. Additional “Cancel“ button can be added, too.
If _IS_CAUTION_DIALOG is FALSE then the notice dialog is displayed with “OK“ button.

Visual SCIL Objects
VS_NOTICE_DIALOG

Data type: Boolean
_LEADER_DIALOG
Defines a leader-follower relationship between dialogs. When a dialog' s leader is opened, closed,
side-effect. The exact implications of this designation are window system dependent; typically,
destroyed, the other dialog' s reference to it is deleted automatically. The _LEADER_DIALOG
attribute of a dialog must be set before the dialog is opened. Dialogs also inherit attributes from their
leaders if the attributes are not specified in the dialog itself or its class. For example, _ICON,
_FOREGROUND_COLOR, _BACKGROUND_COLOR and _FONT are inherited.

Access: Write-only
_LEADER_DIALOG_ITEM
Like _LEADER_DIALOG attribute _LEADER_DIALOG_ITEM attribute defines a leader dialog for the
given window. The leader dialog is the one, which holds the item specified. For more information
about leader-follower dialogs relationship see description of the _LEADER_DIALOG attribute. Setting
this attribute to empty text unsets the leader dialog for the given window.
dialog as leader because the holding dialog is not accessible directly from the picture context.
Example:
_MAX_HEIGHT
_MAX_WIDTH
_MAXIMIZED

Visual SCIL Objects
VS_NOTICE_DIALOG

Data type: Boolean
_MIN_HEIGHT
_MIN_WIDTH
_MODAL
Designates whether or not the window should grab pointer and key input from other windows when it
is opened. The effect when the _MODAL attribute is TRUE is that it is impossible to activate another
window as long as the MODAL window is open.

Data type: Boolean
Default value: TRUE
_NO_TITLE
The title of the “No“ button can be changed by setting this attribute.

Data type: Text
_NOTICE_ICON
Specifies the reference to dialog item used as a icon in notice dialog.

ICON_INFORMATION, ICON_CAUTION or
ICON_CRITICAL.
Data type: Text
Default value: Not applicable
Access: Write-only
_OBJECT_CLASS
_OBJECT_NAME
_OK_TITLE
The title of the “OK“ button can be changed by setting this attribute.

Visual SCIL Objects
VS_NOTICE_DIALOG

Data type: Text
_OPEN
Setting the _OPEN attribute to TRUE opens the window so it is visible at its current position and size
on the display. Setting the attribute to FALSE closes but does not delete the window.

Data type: Boolean
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_STYLE
The style flags determine what decorations, if any, are placed around the window's border as well as

STYLE_BACKGROUND causes the dialog to update its
background.
STYLE_BACKGROUND
This attribute sets the opacity of the window. Without the STYLE_BACKGROUND attribute the
Unclosable icons.
STYLE_DOCUMENT
The visual effect of setting style flags is platform dependent and not all platforms can distinguish all

Visual SCIL Objects
VS_NOTICE_DIALOG

STYLE_BACKGROUND - An opaque background,
STYLE_BORDER - A border around the content area,
STYLE_MOVABLE - A title bar or other draggable area,
STYLE_RESIZABLE - Resize handles or a grow box,
STYLE_ICONIFIABLE - An iconify/minimize box,
STYLE_MAXIMIZABLE - A maximize/zoom box,
STYLE_MAIN - The top-level, non-document window,
STYLE_DOCUMENT - Window contains a document,
STYLE_CONFIRM - Window is a confirmation dialog,
STYLE_UNCLOSABLE - No close box,
Data type: Vector
"STYLE_RESIZABLE")
_TEXT
Specifies the text used in notice dialog. Additional ASCII(10) characters can be added as line breaks
into text string.

Data type: Text
Access: Write-only
_TITLE
The title of the window. Note that the title may not be visible under certain circumstances. For

Data type: Text
_VARIABLE_NAMES
_YES_TITLE
The title of the “Yes“ button can be changed by setting this attribute.

Data type: Text

Visual SCIL Objects
VS_NOTICE_DIALOG
30.2.4 Predefined Methods GUID-AA065BD4-3C7D-4CCF-B47C-233F48CFD733 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_POINTER_POS
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_PLACE
Positions dialogs relative place compared to another dialog. The BASE parameter specifies the
PLACE_BOTTOM.

Visual SCIL Objects
VS_NOTICE_DIALOG

Parameter(s)
X_FLAGS Vector
Y_FLAGS Vector
Example:



Visual SCIL Objects
VS_NOTICE_DIALOG

Parameter(s)
BASE Dialog Item
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:


Positions dialogs relative place compared to given rectangle. The RECT parameter specifies the
PLACE_BOTTOM.

Visual SCIL Objects
VS_NOTICE_DIALOG

Parameter(s)
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
PLACE_BOTTOM.

Visual SCIL Objects
VS_NOTICE_DIALOG

Parameter(s)
RECT List
X_FLAGS Vector
Y_FLAGS Vector
Example:
_RAISE
_SET_MAX_SIZE
_SET_MIN_SIZE

Visual SCIL Objects
310
VS_NUMERIC_SPINNER
Section 31 VS_NUMERIC_SPINNER GUID-11A47C29-8FC4-4AC7-9F98-B4949B22FD7F v1
31.1 Overview GUID-52B1A3FF-C027-4D35-853C-EA3BE9865A8B v1
The VS_NUMERIC_SPINNER object is an object that can have an integral value. The appearance of
the VS_NUMERIC_SPINNER is dependent on the platform. The attributes _MIN_VALUE,
_MAX_VALUE and _INCREMENT_VALUE defines the behaviour of the object. The current value of
an object can be read and set using the _VALUE attribute. The NOTIFY action method for this object
will be called whenever the user interactively changes the value of the object.
31.1.1 Action Attributes GUID-C6A64F2F-72DA-4FED-B6F0-6564CAB93E13 v1
Name Type
31.1.2 Action Methods GUID-D8F3677F-1AC0-4DDF-AD9F-0887CA87DE14 v1
Name Type
31.1.3 Predefined Attributes GUID-2F7F7311-FFC3-484E-AE57-B52C85A33D4B v1
Name Type
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_INCREMENT_VALUE" Integer

Visual SCIL Objects
VS_NUMERIC_SPINNER
"_MAX_VALUE" Integer
"_MIN_VALUE" Integer
"_OBJECT_NAME" Text
"_VALUE" Integer
"_VISIBLE" Boolean
31.1.4 Predefined Methods GUID-D0D9F279-6C7A-4EA2-A754-281971F1623F v1
Name Type
31.2 Details GUID-1E576810-0985-4BB4-9AD6-152B4A7E1D2E v1
31.2.1 Action Attributes GUID-8C9F4651-FFB7-4BE2-B493-1D011B91F738 v1
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_NUMERIC_SPINNER
31.2.2 Action Methods GUID-32CC37F0-B2B0-49D2-ACD9-59094A49A1A7 v1
GET_TABLE_EDIT_TEXT
This action method is executed whenever A table needs a value from an edit object. This method is
GET_TABLE_VIEW_TEXT
NOTIFY
TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_NUMERIC_SPINNER
the cell.
31.2.3 Predefined Attributes GUID-EF79F208-3ED2-4779-B598-DA4747D9CDC4 v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Visual SCIL Objects
VS_NUMERIC_SPINNER

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_INCREMENT_VALUE
Indicates the minor increment step size, for example for a control object.

Data type: Integer
Default value: 1
Example:
.SET MY_CONTROL._INCREMENT_VALUE = 5

Visual SCIL Objects
VS_NUMERIC_SPINNER
_MAX_VALUE
Indicates the maximum value of a control object.

Data type: Integer
Default value: 1
Example:
.SET MY_CONTROL._MAX_VALUE = 10
_MIN_VALUE
Indicates the minimum value of a control object.

Data type: Integer
Default value: 0
Example:
.SET MY_CONTROL._MIN_VALUE = 1
_MODIFIABLE
Specifies whether the value of a numeric spinner is modifiable or not. A change of appearance is
also often combined with this attribute.

Data type: Boolean
Default value: TRUE
_OBJECT_CLASS
_OBJECT_NAME
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text

Visual SCIL Objects
VS_NUMERIC_SPINNER
Example:
_VALUE
Indicates the current value of a control object.

Data type: Integer
Default value: 0
Example:
_VARIABLE_NAMES
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
_WRAP_ENABLED
Specifies whether the values displayed in a numeric spinner can increase or decrease straight from
one end point of the spinner to another end point (for example, from the maximum value to the
minimum value). Maximum and minimum values of a numeric spinner are specifiied by using the
attributes _MIN_VALUE and _MAX_VALUE.

Data type: Boolean
31.2.4 Predefined Methods GUID-94DF33EE-85AB-4186-9BE7-7D51A9CC6640 v1
_FLAG_FOR_EXECUTION
_GET_HELP

Visual SCIL Objects
VS_NUMERIC_SPINNER
_GET_STRING_WIDTH

Parameter(s)
STRING Text

Visual SCIL Objects
VS_OPTION_BUTTON
Section 32 VS_OPTION_BUTTON GUID-69008A8F-724B-4BBE-ACC1-DD30D42EAD34 v1
32.1 Overview GUID-77AE38C6-2E34-44F6-B750-D02E4092C25F v1
A VS_OPTION_BUTTON object is an object that can be selected but not cleared (deselected). The
appearance of the option button is dependent on the graphics platform. The attribute _VALUE
contains the current state of the option button. The NOTIFY action method is called when the option
button is selected. When option buttons are used in a group, all other option buttons should be
cleared when one is selected. Other option buttons should be cleared from SCIL in NOTIFY action
method of the selected option button.
32.1.1 Action Attributes GUID-2C67ED50-F01F-4819-ABF7-63B05EA6015D v1
Name Type
32.1.2 Action Methods GUID-1EAB5F84-3A1F-4969-BDCF-4A9F65B9A2B4 v1
Name Type
32.1.3 Predefined Attributes GUID-2F1652DD-D3A7-430E-8515-E1BD76D28B8D v1
Name Type
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List

Visual SCIL Objects
VS_OPTION_BUTTON
"_MNEMONIC" Text
"_OBJECT_NAME" Text
"_TITLE" Text
"_VALUE" Integer
"_VISIBLE" Boolean
32.1.4 Predefined Methods GUID-CA2E0E30-B18E-436A-B39E-B656B0C94753 v1
Name Type
32.2 Details GUID-294859AE-4273-485F-99B8-E29B2B3FC550 v1
32.2.1 Action Attributes GUID-CC5FB22E-A52E-49DE-A59D-7F128296DBE3 v1
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_OPTION_BUTTON
32.2.2 Action Methods GUID-CC81B307-2DCA-4AD3-A154-003F9977CF09 v1
GET_TABLE_EDIT_TEXT
GET_TABLE_VIEW_TEXT
NOTIFY
TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_OPTION_BUTTON
the cell.
32.2.3 Predefined Attributes GUID-9D95D941-2B33-4E50-8832-07A269AD758D v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Example:
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Visual SCIL Objects
VS_OPTION_BUTTON

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_MNEMONIC
Specifies the mnemonic character of a dialog item. The mnemonic may be visualized differently on

Data type: Text
Example:

Visual SCIL Objects
VS_OPTION_BUTTON
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
the object.

Example:
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TITLE

Data type: Text
Example:
_TOOLTIP_TEXT
Data type: Text
Example:

Visual SCIL Objects
VS_OPTION_BUTTON
_VALUE

Data type: Integer
Default value: 0
Example:
_VARIABLE_NAMES
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
32.2.4 Predefined Methods GUID-F9E427EB-B4F8-4AB5-845E-53C50D24DAEB v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text

Visual SCIL Objects
326
VS_PALETTE
Section 33 VS_PALETTE GUID-E080AAAE-87BE-4E57-BDBD-C879AFDEE7AA v1
33.1 Overview GUID-47A291E2-BC20-409C-B5C4-6EE39FDC0704 v1
The VS_PALETTE object is an object that contains buttons. Buttons are added to the VS_PALETTE
using the _APPEND_BUTTON method. Objects of type VS_IMAGE can be placed on buttons using
the method _SET_BUTTON_IMAGE. The NOTIFY method for this object will be called either when
pressing or releasing a button depending on the value of the _NOTIFY_ON_BUTTON_UP attribute.
33.1.1 Action Attributes GUID-47C9E322-495C-4F36-9D3D-75673906E63A v1
Name Type
33.1.2 Action Methods GUID-C37433C0-8A7B-4E70-8599-9891B1F4625D v1
Name Type
33.1.3 Predefined Attributes GUID-FF23F3D8-4E9C-4AFF-89A1-C1C9F8EA3042 v1
Name Type
"_BUTTON_COUNT" Integer
"_BUTTON_HEIGHT" Integer
"_BUTTON_WIDTH" Integer
"_CLICK_COUNT" Integer
"_COLUMN_COUNT" Integer
"_ENABLED" Boolean

Visual SCIL Objects
VS_PALETTE
"_FOCUSED" Boolean
"_GEOMETRY" List
"_HAS_FLAT_APPEARANCE" Boolean
"_OBJECT_NAME" Text
"_SELECTED_BUTTON_INDEX" Integer
"_VISIBLE" Boolean
33.1.4 Predefined Methods GUID-67158200-A6DE-46B7-8979-77D32C8B68B1 v1
Name Type
"_APPEND_BUTTON" No return value
"_REMOVE_BUTTON_AT" No return value
"_SET_BUTTON_IMAGE" No return value
"_SET_BUTTON_SIZE" No return value
33.2 Details GUID-7FAA04B3-234C-4A6E-9AED-156FDE0B893F v1
33.2.1 Action Attributes GUID-0947DE97-72D3-43F1-97C0-A130A1BD9120 v1

Visual SCIL Objects
VS_PALETTE
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN
33.2.2 Action Methods GUID-DBD4DA4D-CB44-413C-ADA5-A4A4982D0BD7 v1
GET_TABLE_EDIT_TEXT
GET_TABLE_VIEW_TEXT
NOTIFY
TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_PALETTE
the cell.
33.2.3 Predefined Attributes GUID-941F7948-0336-405C-B0F1-65138E20310F v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_BUTTON_COUNT
Specifies the number of appended buttons in a palette.

Data type: Integer
Default value: 0
Access: Read-only
_BUTTON_HEIGHT
Specifies the height of a button in a palette.

Data type: Integer
Default value: 20
Access: Read-only
_BUTTON_WIDTH
Specifies the width of a button in a palette.

Visual SCIL Objects
VS_PALETTE

Data type: Integer
Default value: 20
Access: Read-only
_CHILD_OBJECTS
_CLICK_COUNT
Returns the number of mouse clicks assigned into a palette. The value of attribute _CLICK_COUNT
is purposed to read inside NOTIFY action method. This function is used to test, for example, double
and triple clicks. Note that the attribute value is automatically set to default value when NOTIFY is
executed.

Data type: Integer
Default value: 0
Access: Read-only
Example:
; Notify method of palette
@NUMBER_OF_CLICKS = ROOT\ MY_PALETTE._CLICK_COUNT
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_COLUMN_COUNT
Specifies the number of used columns in a palette.

Data type: Integer
Default value: 1
_ENABLED

Visual SCIL Objects
VS_PALETTE
Table 1:

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_GEOMETRY
Example:
view as if the user grabbed it, so that the scrolling of the view and the movement of the mouse are
synchronous.

Visual SCIL Objects
VS_PALETTE

Data type: Boolean
_HAS_BORDER

Data type: Boolean
Example:
_HAS_FLAT_APPEARANCE
Determines whether the VS_PALETTE should be drawn Flat or not.

Data type: Boolean
Example:
.SET MY_PALETTE._HAS_FLAT_APPEARANCE = TRUE
The mouse over feature is not available for VS_PALETTE. Flat appearance is visible
only for tools opened in Modern LAF.

Data type: Boolean
When set to TRUE, this attribute specifies whether an object allows keyboard selection through
keyboard focus. This means, for example, that when a list has focus and a key is pressed, the
selected cell of the list changes to the first one that starts with the character pressed.

Visual SCIL Objects
VS_PALETTE

Data type: Boolean
Default value: TRUE
Specifies if keyboard traversal is used in list elements or not. If the value is TRUE, the object
responds to keyboard commands. In this case, the user can make selections or change the focused
cell with keyboard arrow keys. If value is FALSE, the object will only handle the mouse events. In this
case, the user can make selections or change the focused cell only with mouse.

Data type: Boolean
Default value: TRUE
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
an object.

Example:
_ROW_COUNT
Specifies the number of used rows in a palette.

Data type: Integer
Default value: 0
Access: Read-only
_SCIL_GEOMETRY

Visual SCIL Objects
VS_PALETTE
_SELECTED_BUTTON_INDEX
Specifies the index of a selected button in a palette.

Data type: Integer
Default value: 0
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text
Example:
Specifies whether the content of a list wraps around or not.

Data type: Boolean
Default value: TRUE
_VARIABLE_NAMES

Data type: Boolean
Default value: TRUE
_VISIBLE

Data type: Boolean
Default value: TRUE

Visual SCIL Objects
VS_PALETTE
Example:
33.2.4 Predefined Methods GUID-3A087431-1417-4907-9F54-508D6BE9176C v1
_APPEND_BUTTON
Inserts a button into a palette. The new button is attached to the end of the palette. A new index is
assigned into inserted button.
Example:
.CREATE ROOT\ MY_PALETTE = VS_PALETTE(-
_GEOMETRY = LIST(...
_OPEN = TRUE)
ROOT\ MY_PALETTE._APPEND_BUTTON
ROOT\ MY_PALETTE._SET_BUTTON_IMAGE(1, “ROOT\ IMAGE1“)
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_REMOVE_BUTTON_AT
Removes a button with specified index from a palette. The indices after the removed button are
decreased by one. Due to this, the indices of buttons should be rearranged after using this method.

Parameter(s)
INDEX Integer
An integer value.
Example:
ROOT\ MY_PALETTE._REMOVE_BUTTON_AT(1)

Visual SCIL Objects
VS_PALETTE
Scrolls a list so that the selection is displayed in the view.
_SET_BUTTON_IMAGE
Sets the image of a specific button in the palette.

Parameter(s)
INDEX Integer
An integer value.
_SET_BUTTON_SIZE
Sets the width and height of all the buttons in a palette. If images are shown on the buttons, they are
placed in the centre of the button. Note that if images are to be displayed on the buttons, the images
should be drawn to adjust with a specified button size. If the button size is changed later, the images
will not be scaled.

Parameter(s)
W Integer
An integer value.
H Integer
An integer value.
Example:
ROOT\ MY_PALETTE._SET_BUTTON_SIZE(25, 25)

Visual SCIL Objects
338
VS_PICTURE_CONTAINER
Section 34 VS_PICTURE_CONTAINER GUID-3FF43AF3-D99B-4454-9BAF-1B554C338AEB v1
34.1 Overview GUID-517D3C33-8780-4B39-B1BF-3AC4210014FC v1
The picture container VS_PICTURE_CONTAINER is an object that serves as a container for

conventional pictures. This object works as a barrier between the SCIL context of the containing
dialog and the picture. It also works as a wall in the object visibility space.
34.1.1 Action Attributes GUID-E363C3E2-DA84-4031-B3E9-DB43EE04CAEC v1
Name Type
34.1.2 Action Methods GUID-4B814DD1-0209-471A-9978-821513155809 v1
Name Type
34.1.3 Predefined Attributes GUID-5A382D4A-4AB9-4F5A-BDA2-46C1D05F195C v1
Name Type
"_BUSY" Boolean
"_CONTENT_GEOMETRY" List
"_ENABLED" Boolean
"_FONT" Font
"_GEOMETRY" List

Visual SCIL Objects
"_OBJECT_NAME" Text
"_PICTURE_NAME" Text
"_VISIBLE" Boolean
34.1.4 Predefined Methods GUID-9557DB11-8EFE-4B74-86C5-2F277EC29775 v1
Name Type
_GET_STRING_WIDTH Integer
"_INT_PIC" No return value
"_LAST_PIC" No return value
"_NEW_PIC" No return value
"_SHOW_BACK" No return value
34.2 Details GUID-66CBC5C7-C380-498D-B30E-35629A7EE0E7 v1
34.2.1 Action Attributes GUID-0E5AF6CB-4F65-49C4-81AD-77201C8980D7 v1
_TOOLTIP_IS_SHOWN

Visual SCIL Objects
34.2.2 Action Methods GUID-04FF4229-C7BA-4160-BBE1-5B5054807181 v1
GET_TABLE_EDIT_TEXT
GET_TABLE_VIEW_TEXT
TOOLTIP_IS_SHOWN
the cell.
34.2.3 Predefined Attributes GUID-005136EF-7DFD-45CB-A863-208DCE83F4D0 v1
_ATTRIBUTE_NAMES

Visual SCIL Objects
_BACKGROUND_COLOR
Example:
_BOUNDS_GEOMETRY
The BOUNDS_GEOMETRY is the entire virtual coordinate space of a container. Position (0,0) in the
container coordinate system is at the lower left corner of the BOUNDS_GEOMETRY. The
BOUNDS_GEOMETRY is interpreted in the same coordinate space as the GEOMETRY of the
object. Each object in the container is placed relative to the lower left corner of the
BOUNDS_GEOMETRY.

system.
Data type: List
_BUSY
Setting the _BUSY attribute to TRUE changes the appearance of an object to indicate that the object
is unavailable to the user. On Windows platform, the cursor is displayed as an hour glass. This
function is normally used to indicate that a long operation is about to occur. This attribute is

Data type: Boolean
Access: Write-only
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_CONTENT_GEOMETRY
The CONTENT_GEOMETRY is the portion of the coordinate space that is visible to the user at any
given moment. If CONTENT_GEOMETRY is smaller than BOUNDS_GEOMETRY, the scroll bars

Visual SCIL Objects
must be inserted for horizontal and vertical scrolling. The BOUNDS_GEOMETRY is clipped to
CONTENT_GEOMETRY when the interior of a container is drawn.

system.
Data type: List
Access: Read-only
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_HAS_BORDER

Visual SCIL Objects

Data type: Boolean
Example:
Specifies whether a container has a horizontal scroll bar.

Data type: Boolean
Example:
.SET MY_CONTAINER._HORIZONTAL_SCROLL_BAR_ENABLED = TRUE
_ITEM_COUNT
Specifies the number of dialog items in an object. This attribute specifies the number of dialog items
added directly into the object. Since certain dialog items may contain others (for example containers),

Data type: Integer
Default value: 0
Access: Read-only
Example:
_OBJECT_CLASS
_OBJECT_NAME
_PICTURE_NAME
A read only attribute that contains the name of a picture currently shown in the picture container.

Data type: Text

Visual SCIL Objects
_POP_UP_MENU
the object.
If user want's to use _POP_UP_MENU with this object, this object must be inserted
in VS_CONTAINER and all other items should be also inserted in VS_CONTAINER
or VS_NOTEBOOK.

Example:
.LOAD ROOT\MENU1 = VS_MENU("...
.SET ROOT\MY_LIST._POP_UP_MENU = "ROOT\MENU1"
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text
Example:
_VARIABLE_NAMES
Specifies whether a container has a vertical scroll bar.

Data type: Boolean
Example:
.SET MY_CONTAINER._VERTICAL_SCROLL_BAR_ENABLED = TRUE

Visual SCIL Objects
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
34.2.4 Predefined Methods GUID-65EBDA5F-D8E5-4CF7-896F-4348663CC6BC v1
_FLAG_FOR_EXECUTION
_GET_HELP
_INT_PIC
Displays an alarm picture. Incoming alarms are put into a monitor specific picture queue. This
method displays the oldest alarm picture in the queue. At the same time, the name of the picture is
removed from the alarm picture queue. Note that if the alarm picture queue is empty, the method has
no effect.
_LAST_PIC
Displays the previous picture. This method causes the picture handling unit to go one step
backwards in the queue built up by _NEW_PIC method in picture container.
_NEW_PIC
Shows the picture with the given name in the picture container. The name can be given as a simple
name, as path/name or as a full path name. The name is resolved in the callers context.

Parameter(s):
NAME Text
_SHOW_BACK
Shows the background of a specified picture in a container.

Visual SCIL Objects

Parameter(s):
NAME Text

Visual SCIL Objects
348
VS_PRINT_OBJECT
Section 35 VS_PRINT_OBJECT GUID-E1F07D7E-8C26-4D81-9336-793C93E883DD v1
35.1 Overview GUID-DB69D3FF-4550-46D8-91D7-9FF561A1E0AF v1
A VS_PRINT_OBJECT enables the user to setup a printer, print specified dialog or text to a default
printer. The method _SETUP_PRINTER opens a platform dependent printer setup dialog. The
method _PRINT_TEXT_VECTOR prints text vector to a default printer according to the default
margins.
35.1.1 Action Attributes GUID-8F42D86D-373E-417E-B02A-3251F8C5BFAD v1
Name Type
35.1.2 Action Methods GUID-9A820E1C-ED1E-4FDC-B573-D81197E4115A v1
Name Type
35.1.3 Predefined Attributes GUID-82384BAF-BE05-4FAA-B7DE-5A70C2EB198F v1
Name Type
"_FONT" Font
"_JOB_CONFIRMATION_ENABLED" Boolean
"_LANDSCAPE_ENABLED" Boolean
"_OBJECT_NAME" Text
"_PAGE_GEOMETRY" List
"_PAPER_GEOMETRY" List
"_PRINT_PAGE_RANGE_ENABLED" Boolean
"_TEXT_WRAP_ENABLED" Boolean

Visual SCIL Objects
VS_PRINT_OBJECT
35.1.4 Predefined Methods GUID-F7E1B09A-E6D9-43D5-8764-8DC74A7BC4EB v1
Name Type
"_CLOSE_PRINT_SESSION" Integer
"_CLOSE_PRINTER" Boolean
"_GET_DIALOG_PRINT_SCALE" List
"_GET_MARGINS" List
"_OPEN_PRINT_SESSION" Integer
"_OPEN_PRINTER" Boolean
"_PRINT_DIALOG" Integer
"_PRINT_ROW_DATA" No return value
"_PRINT_TABLE" Integer
"_PRINT_TABLE_COLUMNHEADER" No return value
"_PRINT_TEXT_VECTOR" Integer
"_SET_DIALOG_PRINT_SCALE" No return value
"_SET_MARGINS" No return value
"_SET_PAGEFOOTER" No return value
"_SET_PAGEHEADER" No return value
"_SETUP_PRINTER" Integer
35.2 Details GUID-896EABB3-6121-45BE-A33C-F899E6981316 v1
35.2.1 Action Attributes GUID-24DD0255-87E2-4E83-8AB4-53CFFF83C712 v1
_GOT_FOCUS_NOTIFY
_KEY_PRESSED
_LOST_FOCUS_NOTIFY
35.2.2 Action Methods GUID-3AE563F4-94A4-4461-B4D5-E30F5BAC056E v1
GOT_FOCUS_NOTIFY
This action method is executed immediately after a dialog has got input focus.

Visual SCIL Objects
VS_PRINT_OBJECT
KEY_PRESSED
This action method is executed after a key or a key combination is pressed in the dialog that has
LOST_FOCUS_NOTIFY
This action method is executed immediately after a dialog has lost input focus.
35.2.3 Predefined Attributes GUID-7F0007F6-1F6D-4FFE-A3A5-F5FB12E1072B v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
_CHILD_OBJECTS
_FILE_REVISION
_FONT
_FOREGROUND_COLOR
_JOB_CONFIRMATION_ENABLED
Specifies whether the print job confirmation dialog is used or not. Some platforms may simply confirm
that the printer's attributes reflect the user's preferences.
In the current version this attribute is always TRUE.

Data type: Boolean
Default value: TRUE
_LANDSCAPE_ENABLED
Specifies whether the print page orientation is landscape or not.

Visual SCIL Objects
VS_PRINT_OBJECT
_LANDSCAPE_ENABLED setting does not have any effect when printing with F3
key.

Data type: Boolean
_LEADER_DIALOG_ITEM

leader-follower dialogs relationship, see the description of the _LEADER_DIALOG attribute.
context.
Example:
_OBJECT_CLASS
_OBJECT_NAME
_PAGE_GEOMETRY
Returns the page rectangle of the default printer.

system.
Data type: List
Access: Read-only
_PAPER_GEOMETRY
Returns the paper rectangle of the default printer.

Visual SCIL Objects
VS_PRINT_OBJECT

system.
Data type: List
Access: Read-only
_PRINT_PAGE_RANGE_ENABLED
When this attribute is TRUE, the Pages selection on Print Job Confirmation dialog is enabled if
supported by the operating system.

Data type: Boolean
_SOURCE_FILE_NAME
_TEXT_WRAP_ENABLED
Specifies whether text wrap is enabled or not. When this attribute is set to TRUE, the lines that are
wider than the paper width are wrapped to the next line.

Data type: Boolean
_VARIABLE_NAMES
35.2.4 Predefined Methods GUID-FBEEA997-BE32-4F1A-AE10-01028A2AF4BD v1
_CLOSE_PRINT_SESSION
This method should be called after calling _PRINT_DIALOG and/or _PRINT_TEXT_VECTOR if the
user has previously called _OPEN_PRINT_SESSION. _CLOSE_PRINT_SESSION starts the printing
of current documents on the printer. If the user has sent documents to the printer by
_PRINT_DIALOG or _PRINT_TEXT_VECTOR, those are not printed until
_CLOSE_PRINT_SESSION is called.
_CLOSE_PRINTER
This method should be called after calling _PRINT_DIALOG and/or _PRINT_TEXT_VECTOR if the
user has previously called _OPEN_PRINTER. _CLOSE_PRINTER starts the printing of current
documents on the printer. If the user has sent documents to the printer by _PRINT_DIALOG or
_PRINT_TEXT_VECTOR, those are not printed until calling _CLOSE_PRINTER. If the printer is not
open, FALSE is returned.

Visual SCIL Objects
VS_PRINT_OBJECT
_FLAG_FOR_EXECUTION
_GET_DIALOG_PRINT_SCALE
Returns the scale ratios (width/height) which are used when printing a dialog.
_GET_MARGINS
Returns the margins used in default printer.
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_OPEN_PRINT_SESSION
This method should be called prior to calling _PRINT_DIALOG or _PRINT_TEXT_VECTOR when
wanting to print several dialogs or text vectors in one print session. If
_JOB_CONFIRMATION_ENABLED == TRUE, _OPEN_PRINT_SESSION causes a job confirmation
dialog to open if supported by the operating system.
_OPEN_PRINTER
This method should be called prior to calling _PRINT_DIALOG or _PRINT_TEXT_VECTOR when
wanting to print several dialogs or text vectors in one print session. If
_JOB_CONFIRMATION_ENABLED == TRUE, _OPEN_PRINTER causes a job confirmation dialog
to open if supported by the operating system. If the printer is already opened, FALSE is returned and
no confirmation dialog is opened.
Currently, _JOB_CONFIRMATION_ENABLED is always TRUE. If there is no local

printer defined on VS Monitor, the SCIL error status 461
(SCIL_EXCEPTION_IN_METHOD_CALL) is generated.
Positions a dialog's relative place compared to a given rectangle in the coordinate system of a dialog
Usually, BASE specifies the kind of container (VS_CONTAINER, VS_NOTEBOOK_PAGE, etc.), and

Visual SCIL Objects
VS_PRINT_OBJECT

Parameter(s)
BASE Dialog Item
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:


MY_DIALOG._PLACE(“YOUR_CONTAINER“, %GEOM,
(“PLACE_CENTER“), (“PLACE_CENTER“))

Visual SCIL Objects
VS_PRINT_OBJECT
_PRINT_DIALOG
Prints the content of a dialog to the default printer. Note that only the specified dialog is printed, not
the overlapping windows. If the user has pressed cancel on the job confirmation dialog, status code
PRINT_JOB_NOT_CONFIRMED is returned. Zero (0) is returned, if the method was executed
succesfully.

Parameter(s):
DIALOG Dialog reference
A reference to a dialog object.
If there is no local printer defined on VS Monitor, the SCIL error status 461
_PRINT_ROW_DATA
This function is used to set the row contents of a table.

Parameter(s):
TEXT_VECTOR Vector
A vector containing only text elements.
_PRINT_TABLE
Prints the table contents passed to a default printer according to the data set by the methods like
_PRINT_ROW_DATA, _PRINT_TABLE_COLUMNHEADER, _SET_PAGEHEADER, and
_SET_PAGEFOOTER. This function should be called only after setting all data by the previously
mentioned functions.
If the table contents are not set or if there is any invalid or insufficient data then the
SCIL error status 600 (SCIL_INVALID_VECTOR_LENGTH) is generated. If the
Harmonized Print dialog library, ReportPrint.dll is not found then the SCIL error
status 5007 (FILE_DOES_NOT_EXIST) is generated.
_PRINT_TABLE_COLUMNHEADER
This function is used to set the column names of the table to be printed. If the table has two rows of
column name, call the function twice with the respective rows text as the vector.

Parameter(s):
TEXT_VECTOR Vector
_PRINT_TEXT_VECTOR
Prints a passed text vector to a default printer. Zero (0) is returned, if the method was executed
successfully.

Visual SCIL Objects
VS_PRINT_OBJECT

Parameter(s):
TEXT_VECTOR Vector
If the harmonized print dialog library, ReportPrint.dll is not found then the SCIL error
status 5007 (FILE_DOES_NOT_EXIST) is generated.
For more information on this item, see Section 3.
_SET_DIALOG_PRINT_SCALE
Sets the scale ratios (width/height) that are used when printing a dialog.

Parameter(s):
WIDTH_RATIO Integer
An integer value
HEIGTH_RATIO Integer
An integer value
_SET_MARGINS
Sets the margins used in the default printer. If _SET_MARGINS method is not used, the printer
default margins are used.

Parameter(s):
TOP Integer
An integer value
BOTTOM Integer
An integer valu
LEFT Integer
An integer value
RIGHT Integer
An integer value
_SET_PAGEFOOTER
This function is used to set the footer items of a page.

Parameter(s):
COUNT Text
MODE Text
_SET_PAGEHEADER
This function is used to set the header items of a page.

Visual SCIL Objects
VS_PRINT_OBJECT

Parameter(s):
PAGE Text
APPLICATION Text
TOOL Text
_SETUP_PRINTER
Opens a setup printer dialog. Status code PRINT_SETUP_NOT_CONFIRMED is returned in case
the user has pressed cancel on the setup confirmation dialog. Zero (0) is returned, if the method was
executed successfully.
If no local printer defined on VS Monitor, the SCIL error status 461


Visual SCIL Objects
VS_PROGRAM_EDITOR
Section 36 VS_PROGRAM_EDITOR GUID-D208C1BF-0F77-476D-A109-2183CFDB1D9A v1
36.1 Overview GUID-5C4CDCE1-D21F-45AB-9E4A-9EAC7ADB83DA v1
The VS_PROGRAM_EDITOR object is a SCIL sensitive text editor that can be used to edit SCIL
programs or text files. The text that is to be edited is inserted into the editor through the _PROGRAM
attribute and read from the same attribute at any point of time. The _PROGRAM_IS_MODIFIED
attribute indicates whether or not the text has been modified. The CLOSE_NOTIFY action method
automatically runs the MENU_EXIT action method.
36.1.1 Action Attributes GUID-885D9E48-9B33-4C9C-A892-E175FA9903DE v1
Name Type
"_MENU_ABOUT" Text vector
"_MENU_EXIT" Text vector
"_MENU_EXPORT" Text vector
"_MENU_IMPORT" Text vector
"_MENU_NEW" Text vector
"_MENU_OPEN" Text vector
"_MENU_PRINT" Text vector
"_MENU_PRINT_SETUP" Text vector
"_MENU_SAVE" Text vector
"_MENU_SAVE_AS" Text vector
"_MENU_UPDATE" Text vector
36.1.2 Action Methods GUID-EC951C75-7AEB-4510-A3B1-D29D7A74E4F6 v1
Name Type
"MENU_ABOUT" No return value
"MENU_EXIT" No return value
"MENU_EXPORT" No return value
"MENU_IMPORT" No return value
"MENU_NEW" No return value
"MENU_OPEN" No return value
"MENU_PRINT" No return value
"MENU_PRINT_SETUP" No return value
"MENU_SAVE" No return value
"MENU_SAVE_AS" No return value
"MENU_UPDATE" No return value

Visual SCIL Objects
VS_PROGRAM_EDITOR
36.1.3 Predefined Attributes GUID-17C84EFA-F4D9-4B6E-93FE-E4D1A04FED42 v1
Name Type
"_BUSY" Boolean
"_FONT" Font
"_GEOMETRY" List
"_INTERNAL_FILE_MENU_ENABLED" Boolean
"_MODAL" Boolean
"_OBJECT_NAME" Text
"_OPEN" Boolean
"_PROGRAM" Vector
"_PROGRAM_FONT" Font
"_PROGRAM_IS_MODIFIED" Boolean
"_SELECTED_PROGRAM_TEXT" Vector
"_STYLE" Vector
"_TITLE" Text
36.1.4 Predefined Methods GUID-0587E685-33A2-42C5-AD3C-7228268E0495 v1
Name Type
"_CLEAR_MODIFIED_FLAG" No return value
"_GET_SELECTED_PROGRAM_POS" List

Visual SCIL Objects
VS_PROGRAM_EDITOR
36.2 Details GUID-072BDBB8-F1A1-4A21-B6F5-E4EA35105D57 v1
36.2.1 Action Attributes GUID-310D2FB7-5FE0-4CE1-B2C1-FA94C6FDB192 v1
_MENU_ABOUT
Setting this attribute specifies the action method MENU_ABOUT.
_MENU_EXIT
Setting this attribute specifies the action method MENU_EXIT.
_MENU_EXPORT
Setting this attribute specifies the action method MENU_EXPORT.
_MENU_IMPORT
Setting this attribute specifies the action method MENU_IMPORT.
_MENU_NEW
Setting this attribute specifies the action method MENU_NEW.
_MENU_OPEN
Setting this attribute specifies the action method MENU_OPEN.
_MENU_PRINT
Setting this attribute specifies the action method MENU_PRINT.

Visual SCIL Objects
VS_PROGRAM_EDITOR
_MENU_PRINT_SETUP
Setting this attribute specifies the action method MENU_PRINT_SETUP.
_MENU_SAVE
Setting this attribute specifies the action method MENU_SAVE.
_MENU_SAVE_AS
Setting this attribute specifies the action method MENU_SAVE_AS.
_MENU_UPDATE
Setting this attribute specifies the action method MENU_UPDATE.
_NOTIFY
_TOOLTIP_IS_SHOWN
36.2.2 Action Methods GUID-11CAD041-A8B4-4319-8AD8-92328E8CA1B7 v1
MENU_ABOUT
This action method is executed when About has been chosen from the menu.
MENU_EXIT
This action method is executed when Exit has been chosen from the menu.
MENU_EXPORT
This action method is executed when Export has been chosen from the menu.
MENU_IMPORT
This action method is executed when Import has been chosen from the menu.

Visual SCIL Objects
VS_PROGRAM_EDITOR
MENU_NEW
This action method is executed when New has been chosen from the menu.
MENU_OPEN
This action method is executed when Open has been chosen from the menu.
MENU_PRINT
This action method is executed when Print has been chosen from the menu.
MENU_PRINT_SETUP
This action method is executed when Print Setup has been chosen from the menu.
MENU_SAVE
This action method is executed when Save has been chosen from the menu.
MENU_SAVE_AS
This action method is executed when Save As has been chosen from the menu.
MENU_UPDATE
This action method is executed when Update has been chosen from the menu.
NOTIFY
Specifies the notification procedure of an object. The notification procedure gets called for different
specific object.
TOOLTIP_IS_SHOWN
36.2.3 Predefined Attributes GUID-B079799D-90F6-4C8A-9F08-A8695F0D0F63 v1
_ATTRIBUTE_NAMES

Visual SCIL Objects
VS_PROGRAM_EDITOR
_BACKGROUND_COLOR
_BUSY

Data type: Boolean
_CHILD_OBJECTS
_FILE_REVISION
_FOCUSABLE
dependent on the window system, this function only indicates that the window has use for key

Data type: Boolean
Default value: TRUE
_FONT
_FOREGROUND_COLOR
_GEOMETRY
_ICON
reference.

Visual SCIL Objects
VS_PROGRAM_EDITOR

Example:
_ICONIFIED
the window system and the window manager in use. The window manager lets the user manipulate

Data type: Boolean
_INTERNAL_FILE_MENU_ENABLED
Specifies whether or not to use the internal file menu that does not contain certain menu items such
as New, Open, Save and Save As.

Data type: Boolean
Access: Write-only
_LEADER_DIALOG
iconified, uniconified, blocked, or unblocked, any follower dialog receive the same message as a side
effect. The exact implications of this designation are window system dependent. Typically, dialogs
with the same leader are placed in a group by the window system. If either dialog is destroyed, the
other dialog's reference to it is deleted automatically. The _LEADER_DIALOG attribute of a dialog
must be set before the dialog is opened.
are inherited.

Access: Write-only

Visual SCIL Objects
VS_PROGRAM_EDITOR
_MAX_HEIGHT
_MAX_WIDTH
_MAXIMIZED
Setting the _MAXIMIZED attribute to TRUE changes the size of a window so that it encloses its
maximum size or the entire display, which ever is smaller. The window's current position and size are

Data type: Boolean
_MIN_HEIGHT
_MIN_WIDTH
_MODAL
Designates whether or not a window should grab pointer and key input from other windows when it is
opened. When the _MODAL attribute is TRUE, it is impossible to activate another window as long as
the MODAL window is open.

Data type: Boolean
_OBJECT_CLASS
_OBJECT_NAME
_OPEN

Data type: Boolean

Visual SCIL Objects
VS_PROGRAM_EDITOR
_PROGRAM
A text vector containing the program or text that is going to be edited or the already edited program.
This attribute can be read or written at any time during the editing of the text. Note that the maximum
number of elements in text vector is 10 000.

Data type: Vector
_PROGRAM_FONT
Specifies the font that is being used to display the program that is being edited.
Description: A font as referenced within SCIL.

Data type: Font
_PROGRAM_IS_MODIFIED
A boolean flag that indicates if the program that is being edited has been changed. This flag should
be checked, for example, before saving a program. The flag is cleared from SCIL using the method
_CLEAR_MODIFIED_FLAG. The flag is not used internally by program editor. The program editor
only sets the flag to TRUE when changes has been made to the text that is being edited.

Data type: Boolean
Access: Read-only
_SCIL_GEOMETRY
_SELECTED_PROGRAM_TEXT
A text vector containing the program or text that is selected in the program editor. This attribute can
be read or written at any time during the editing of the text. Note that the maximum number of
elements in text vector is 10 000.

Data type: Vector
Access: Read-only
_SOURCE_FILE_NAME
_STYLE

Visual SCIL Objects
VS_PROGRAM_EDITOR

STYLE_BACKGROUND
This attribute sets the opacity of a window. Without the STYLE_BACKGROUND attribute the window
will contain a border along with header information, and the Iconfiable, Maximize & Unclosable icons.
STYLE_DOCUMENT

Data type: Vector
"STYLE_RESIZABLE")
_TITLE

Data type: Text
_TOOLTIP_TEXT
Data type: Text

Visual SCIL Objects
VS_PROGRAM_EDITOR
Example:
_VARIABLE_NAMES
36.2.4 Predefined Methods GUID-04CE56EE-D63B-4BF9-9878-C39164BB1B60 v1
_CLEAR_MODIFIED_FLAG
Clears the _PROGRAM_IS_MODIFIED flag. This flag should be cleared, for example, when a new
program is being edited and when the program has been saved. The flag is not used internally by
SCIL Program Editor. The SCIL Program Editor only sets the flag to TRUE when changes have been
made to the text that is being edited. Note that when attaching text into SCIL Program Editor by
assigning text vector into _PROGRAM attribute, the flag is automatically set to TRUE. Due to this,
the _CLEAR_MODIFIED_FLAG method should be used after the text has been placed into SCIL
Program Editor.
Example:
.CREATE ROOT\ MY_PROGRAM_EDITOR = VS_PROGRAM_EDITOR(-
_PROGRAM = %My_Program,-
_OPEN = TRUE)
ROOT\ MY_PROGRAM_EDITOR._CLEAR_MODIFIED_FLAG
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_POINTER_POS
_GET_SELECTED_PROGRAM_POS
Returns a list containing the positions of the selected part of a program. The list contains the items
START_LINE, START_COLUMN, END_LINE and END_COLUMN.
_GET_STRING_WIDTH

Visual SCIL Objects
VS_PROGRAM_EDITOR

Parameter(s)
STRING Text
_PLACE
Positions a dialog's relative place compared to another dialog. The BASE parameter specifies the
PLACE_BOTTOM.

Parameter(s)
X_FLAGS Vector
Y_FLAGS Vector
Example:

(“PLACE_TOP“,

Visual SCIL Objects
VS_PROGRAM_EDITOR
“PLACE_ALIGN“))
Positions a dialog's relative place compared to the given rectangle in the coordinate system of a
Usually, BASE specifies a container (VS_CONTAINER, VS_NOTEBOOK_PAGE, etc.), and RECT is

the geometry of a direct child item of that container. However, it is possible to specify any dialog item
as BASE, and any rectangle as RECT.

Parameter(s)
BASE Dialog Item

Visual SCIL Objects
VS_PROGRAM_EDITOR
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
Example 1: Placing MY_DIALOG at TOP/LEFT of the rectangle (0, 0, 100, 100)
within YOUR_CONTAINER:

Positions a dialog's relative place compared to a given rectangle. The RECT parameter specifies the
PLACE_BOTTOM.

Visual SCIL Objects
VS_PROGRAM_EDITOR

Parameter(s)
RECT List
system.
X_FLAGS Vector
Y_FLAGS Vector
Example:
Positions a dialog's relative place compared to a given SCIL rectangle. The RECT parameter

Visual SCIL Objects
VS_PROGRAM_EDITOR

Parameter(s)
RECT List
X_FLAGS Vector
Y_FLAGS Vector
Example:
_RAISE
This method raises a dialog to the top of all other windows.
_SET_MAX_SIZE
_SET_MIN_SIZE

Visual SCIL Objects
VS_SCROLL_BAR
Section 37 VS_SCROLL_BAR GUID-538A3E4E-68C8-4C78-81CF-0336D47CAFF7 v1
37.1 Overview GUID-EE335C3F-4122-4DC8-BA75-A62D34EC9CCF v1
A VS_SCROLL_BAR is a control object that allows the user to drag the scroll box over a linear range
of values in the scroll bar. The NOTIFY action method is called whenever the scroll box is moved
either by dragging or pressing the scroll arrows.
37.1.1 Action Attributes GUID-06A80C9C-C552-4F83-AB25-8E303C7C8F9A v1
Name Type
37.1.2 Action Methods GUID-9983B205-4450-4D82-B592-FC117267F4E1 v1
Name Type
37.1.3 Predefined Attributes GUID-93BD298B-0ED5-4FB0-87B3-2A3C629EEE7E v1
Name Type
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_GEOMETRY" List
"_OBJECT_NAME" Text
"_PAGE_INCREMENT_VALUE" Integer
"_VALUE" Integer

Visual SCIL Objects
VS_SCROLL_BAR
"_VERTICAL" Boolean
"_VIEW_VALUE" Integer
"_VISIBLE" Boolean
37.1.4 Predefined Methods GUID-7E95187E-3D53-4B48-A0F8-7D0F81FE3BB2 v1
Name Type
37.2 Details GUID-356D9AAE-8837-45E9-992D-8A279B603411 v1
37.2.1 Action Attributes GUID-B2CFB826-7BF7-4F33-BE3A-337701B20C1F v1
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN
37.2.2 Action Methods GUID-68E055B4-F3FD-4CC6-AF93-9DAFB956EACE v1
NOTIFY
TOOLTIP_IS_SHOWN
37.2.3 Predefined Attributes GUID-F425CAC5-39FA-470F-B9AF-A25AA8716095 v1
_ATTRIBUTE_NAMES

Visual SCIL Objects
VS_SCROLL_BAR
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Example:
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:

Visual SCIL Objects
VS_SCROLL_BAR
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_INCREMENT_VALUE
Indicates the minor increment step size, for example, for a control object.

Data type: Integer
Default value: 1
Example:
_MAX_VALUE

Data type: Integer
Default value: 1
Example:
_MIN_VALUE

Visual SCIL Objects
VS_SCROLL_BAR

Data type: Integer
Default value: 0
Example:
_OBJECT_CLASS
_OBJECT_NAME
_PAGE_INCREMENT_VALUE
Indicates the major increment step size, for example, for a control object.

Data type: Integer
Default value: 1
Example:
.SET MY_CONTROL._PAGE_INCREMENT_VALUE = 5
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text
Example:
_VALUE

Data type: Integer
Default value: 0

Visual SCIL Objects
VS_SCROLL_BAR
Example:
_VARIABLE_NAMES
_VERTICAL
Indicates that the control object lies along the Y axis instead of along the X axis. Note that this
attribute is not relevant to all kinds of control objects.

Data type: Boolean
Example:
.SET MY_CONTROL._VERTICAL = TRUE
_VIEW_VALUE
Indicates the visible area of the external object that a control object is controlling. This attribute is
relevant, for example, when using a scroll bar to scroll text within a text field. For some look-and-
feels, the size of the thumb of the scroll bar indicates the relative size of the document that is visible.

Data type: Integer
Default value: 0
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
37.2.4 Predefined Methods GUID-444FDC7B-A2EF-4C4E-8E8F-841CCDF4319C v1
_FLAG_FOR_EXECUTION
_GET_HELP

Visual SCIL Objects
VS_SCROLL_BAR
_GET_STRING_WIDTH

Parameter(s)
STRING Text

Visual SCIL Objects
382
VS_SEPARATOR_MENU_ITEM
Section 38 VS_SEPARATOR_MENU_ITEM GUID-EC8AFB2D-3AE2-49DA-BC5A-162C2DE9AB38 v1
38.1 Overview GUID-8BCD42F2-14FD-4E4E-B823-A8C9355013C7 v1
A VS_SEPARATOR_MENU_ITEM is a special kind of menu item that has no command attached to

it. It acts as a separator within the menu, displayed as a horizontal line. The
VS_SEPARATOR_MENU_ITEM is used to group related menu items. When using
VS_TOGGLE_MENU_ITEMs with the _EXCLUSIVE attribute set to TRUE, the
VS_SEPARATOR_MENU_ITEM also defines the scope of the VS_TOGGLE_MENU_ITEMs that are
mutually exclusive. This means that only one menu item can be selected at a time.
38.1.1 Predefined Attributes GUID-11C5FBEC-06E6-4A46-88C2-3926170D24B1 v1
Name Type
"_OBJECT_NAME" Text
38.1.2 Predefined Methods GUID-06AE5885-D543-4800-A069-B5CE9C404F9D v1
Name Type
38.2 Details GUID-DC29DDB7-F37C-49FC-BB96-CA64078D992A v1
38.2.1 Predefined Attributes GUID-46E9DA50-8C77-456B-9026-C51731F671AD v1
_ATTRIBUTE_NAMES
_CHILD_OBJECTS
_FILE_REVISION
_OBJECT_CLASS

Visual SCIL Objects
VS_SEPARATOR_MENU_ITEM
_OBJECT_NAME
_SOURCE_FILE_NAME
_VARIABLE_NAMES
38.2.2 Predefined Methods GUID-75F8B690-8459-417D-9375-282A5005D8CC v1
_FLAG_FOR_EXECUTION
_GET_HELP

Visual SCIL Objects
VS_SLIDER
Section 39 VS_SLIDER GUID-3555756D-74DE-46DC-9C40-1642BDA250CA v1
39.1 Overview GUID-1C057E9F-DC8E-4580-8AD3-F4FE1440F7A6 v1
A VS_SLIDER is a control object that allows the user to drag over a linear range of values.
39.1.1 Action Attributes GUID-6865229A-70A4-412D-8957-133292E50B6F v1
Name Type
39.1.2 Action Methods GUID-8C234CEC-7E84-48A1-BE1B-A5D6D3F3129D v1
Name Type
39.1.3 Predefined Attributes GUID-093F8610-F967-41D6-BD58-FF05FBD7BB41 v1
Name Type
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_GEOMETRY" List
"_OBJECT_NAME" Text
"_PAGE_INCREMENT_VALUE" Integer
"_VALUE" Integer

Visual SCIL Objects
VS_SLIDER
"_VERTICAL" Boolean
"_VIEW_VALUE" Integer
"_VISIBLE" Boolean
39.1.4 Predefined Methods GUID-F301258E-39C1-415D-9446-4346244A8ACC v1
Name Type
39.2 Details GUID-9C42978D-D6BD-45E4-A4D5-7ED1959726C6 v1
39.2.1 Action Attributes GUID-2C27AE8C-86AC-46ED-9F0B-2F07B886DC3C v1
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN
39.2.2 Action Methods GUID-DDC394AC-B8E1-40B8-B51E-D586B6C0E4FE v1
NOTIFY
TOOLTIP_IS_SHOWN
39.2.3 Predefined Attributes GUID-4D1DFC85-D528-4562-A077-CD300BCDE771 v1
_ATTRIBUTE_NAMES

Visual SCIL Objects
VS_SLIDER
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Example:
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:

Visual SCIL Objects
VS_SLIDER
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
_INCREMENT_VALUE
Indicates the minor increment step size, for example, for a control object.

Data type: Integer
Default value: 1
Example:
_MAX_VALUE

Data type: Integer
Default value: 1
Example:
_MIN_VALUE

Visual SCIL Objects
VS_SLIDER

Data type: Integer
Default value: 0
Example:
_OBJECT_CLASS
_OBJECT_NAME
_PAGE_INCREMENT_VALUE
Indicates the major increment step size, for example, for a control object.

Data type: Integer
Default value: 1
Example:
.SET MY_CONTROL._PAGE_INCREMENT_VALUE = 5
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text
Example:
_VALUE

Data type: Integer
Default value: 0
Example:

Visual SCIL Objects
VS_SLIDER
_VARIABLE_NAMES
_VERTICAL
Indicates that a control object lies along the Y axis instead of along the Xaxis. Note that this attribute
is not relevant to all control objects.

Data type: Boolean
Example:
.SET MY_CONTROL._VERTICAL = TRUE
_VIEW_VALUE
Indicates the visible area of the external object that a control object is controlling. This attribute is
relevant, for example, when using a scroll bar to scroll text within a text field. For some look-and-
feels, the size of the thumb of the scroll bar indicates the relative size of the document that is visible.

Data type: Integer
Default value: 0
_VISIBLE
Table 2:

Data type: Boolean
Default value: TRUE
Example:
39.2.4 Predefined Methods GUID-150A34F1-B0F8-4AD4-9FB5-3A9D1912D2BD v1
_FLAG_FOR_EXECUTION
_GET_HELP

Visual SCIL Objects
VS_SLIDER
_GET_STRING_WIDTH

Parameter(s)
STRING Text

Visual SCIL Objects
392
VS_SPLIT_BAR
Section 40 VS_SPLIT_BAR GUID-FA537852-7497-4C39-BA6B-D153300572FB v1
40.1 Overview GUID-7E444ECA-0D48-4716-9268-346F67097544 v1
The split bar is an object meant to be used when the user has to be able to dynamically split an area
into two. The split bas is placed between, for example, two containers. It contains the functionality
needed to make it possible for the user to grab the split bar with the mouse cursor and resize the two
objects that are connected to the sides of the split bar. Note that ony one of the objects connected to
the split bar may have an internal spring connection at most. The NOTIFY action method is executed
every time the split bar it interactively moved by the user.
40.1.1 Action Attributes GUID-C0B547D0-5DC1-4D0F-96F1-D39DCB9E4904 v1
Name Type
40.1.2 Action Methods GUID-06CA4310-58CE-4641-9B51-5ABAB44C74D6 v1
Name Type
40.1.3 Predefined Attributes GUID-67C7DAFE-EF71-41E7-A1C2-0FA02B63FEDB v1
Name Type
"_ENABLED" Boolean
"_GEOMETRY" List
"_OBJECT_NAME" Text
"_POSITION" Integer
"_VERTICAL" Boolean

Visual SCIL Objects
VS_SPLIT_BAR
40.1.4 Predefined Methods GUID-AD614CD7-7A8C-48DF-84A4-232221F62694 v1
Name Type
40.2 Details GUID-25DC7406-563F-4C59-AB3E-AB6BC425191B v1
40.2.1 Action Attributes GUID-0E980442-0745-4600-A8B8-0B6CF3811038 v1
_TOOLTIP_IS_SHOWN
40.2.2 Action Methods GUID-D591F4A4-D357-4A2F-860E-B19ED7F9DF24 v1
NOTIFY
TOOLTIP_IS_SHOWN
40.2.3 Predefined Attributes GUID-94106AA8-BFCE-4723-A0F6-F5BBBA3D8DF9 v1
_ATTRIBUTE_NAMES
_CHILD_OBJECTS
_ENABLED

Visual SCIL Objects
VS_SPLIT_BAR

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_GEOMETRY
Example:
_OBJECT_CLASS
_OBJECT_NAME
_POSITION
By using this attribute, it is possible to programmatically set a default value for the split bar. The value
is the X or Y coordinate of the centre of the VS_SPLIT_BAR in the coordinate space of the object
that contains the split bar.

Data type: Integer
_SCIL_GEOMETRY
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text
Example:

Visual SCIL Objects
VS_SPLIT_BAR
_VARIABLE_NAMES
_VERTICAL
Specifies whether the split bar splits the objects vertically or horizontally.

Data type: Boolean
40.2.4 Predefined Methods GUID-97481D2F-F2A0-42E4-9AB9-74AEC0FB2175 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text

Visual SCIL Objects
VS_SUB_MENU_ITEM
Section 41 VS_SUB_MENU_ITEM GUID-B1D703E4-2C10-4AA2-8D19-33AF7438FF77 v1
41.1 Overview GUID-0CC6C0FF-2DA4-4F5E-8D41-12B8E30C9CFF v1
The VS_SUB_MENU_ITEM behaves like the VS_MENU_ITEM except for the fact that it can contain
a sub-menu that is an ordinary VS_MENU.
41.1.1 Predefined Attributes GUID-100386C8-E1C1-4322-94F0-54EA73943DB7 v1
Name Type
"_ENABLED" Boolean
"_FONT" Font
"_MNEMONIC" Text
"_OBJECT_NAME" Text
"_TITLE" Text
41.1.2 Predefined Methods GUID-F10A7C6B-344C-4D57-900D-780ED9CDDE08 v1
Name Type
41.2 Details GUID-56B1C2DA-D764-4DA0-BDE5-4BD5FBCBD611 v1
41.2.1 Predefined Attributes GUID-958AE3B1-9F41-4C9E-8971-D62F17801FDA v1
_ATTRIBUTE_NAMES
_CHILD_OBJECTS
_ENABLED
Specifies whether a menu item is enabled or not. Changing this attribute also affects the appearance
of the menu item.

Visual SCIL Objects
VS_SUB_MENU_ITEM

Data type: Boolean
Default value: TRUE
_FILE_REVISION
_FONT
_FOREGROUND_COLOR
_IMAGE
Specifies an image that is associated with the object. The way the image is displayed depends on
the object. The image is given as an object reference to the image that has been loaded or created
as an independent object.

using the function .LOAD. The size of the image should
preferably be 16 % 16.
Example:
.LOAD ROOT\ IMAGE1 = VS_IMAGE("...
.SET ROOT\ MY_SUB_MENU_ITEM._IMAGE = "ROOT\ IMAGE1"
_MNEMONIC
mnemonic character in menu item.

Data type: Text
_OBJECT_CLASS
_OBJECT_NAME

Visual SCIL Objects
VS_SUB_MENU_ITEM
_SOURCE_FILE_NAME
_TITLE

Data type: Text
_VARIABLE_NAMES
41.2.2 Predefined Methods GUID-605B3445-1C96-415F-BA76-711D92E8DB35 v1
_FLAG_FOR_EXECUTION
_GET_HELP

Visual SCIL Objects
400
VS_TABLE
Section 42 VS_TABLE GUID-B77FA3B1-6F18-4F61-9084-BA6B223E1C25 v1
42.1 Overview GUID-A4142F23-69C7-4B8C-A542-1DF291CDF15B v1
The VS_TABLE object implements what most developers would refer to as a “spreadsheet widget“ or
a “grid“. Essentially, it' s a two dimensional list of data that can have header information for each row
and/or each column of that list. The VS_TABLE objects can be used to display output information,
but it can also be used to allow the user to enter new data or modify the displayed information. For
more information about the VS_TABLE, see SYS600 Visual SCIL Application Design.
The VS_TABLE does not handle mouse motion events, if it is not inserted inside a
dialog.
42.1.1 Action Attributes GUID-0EEDC1F6-5772-4D3D-B250-61044095B6CA v1
Name Type
"_CELL_EDITING_ACCEPTED" Text vector
"_CELL_EDITING_CANCELLED" Text vector
"_CELL_EDITING_STARTED" Text vector
"_COLUMN_TITLE_CLICKED" Text vector
"_COLUMN_TITLE_DOUBLE_CLICKED" Text vector
"_DRAGGED_AND_DROPPED" Text vector
"_FOCUSED_CELL_CHANGED" Text vector
"_SELECTION_HAS_CHANGED" Text vector
42.1.2 Action Methods GUID-B43BABE2-E4B6-43B6-B689-0684E356A663 v1
Name Type
"CELL_EDITING_ACCEPTED" No return value
"CELL_EDITING_CANCELLED" No return value
"CELL_EDITING_STARTED" No return value
"COLUMN_TITLE_CLICKED" No return value
"COLUMN_TITLE_DOUBLE_CLICKED" No return value
"DRAGGED_AND_DROPPED" No return value
"FOCUSED_CELL_CHANGED" No return value
"SELECTION_HAS_CHANGED" No return value
42.1.3 Predefined Attributes GUID-33DEB4A9-EE6F-4B96-A63D-8C57DE1F5C3F v1
Name Type
"_AUTO_EDIT_ENABLED" Boolean

Visual SCIL Objects
VS_TABLE
"_COLUMN_COUNT" Integer
"_COLUMN_DRAG_AND_DROP_ENABLED" Boolean
"_COLUMN_HEADER_RESIZABLE" Boolean
"_COLUMN_HEADER_SELECTION_ENABLED" Boolean
"_DOUBLE_CLICK_EDIT_ENABLED" Boolean
"_DRAWING_SELECTION_ENABLED" Boolean
"_ENABLED" Boolean
"_EXTEND_COLUMN_SELECTION_ENABLED" Boolean
"_EXTEND_ROW_SELECTION_ENABLED" Boolean
"_FIRST_VISIBLE_COLUMN" Integer
"_FOCUSED" Boolean
"_FOCUSED_CELL" Integer
"_FONT" Font
"_GEOMETRY" List
"_HAS_COLUMN_HEADER" Boolean
"_HAS_ROW_HEADER" Boolean
"_HORIZONTAL_GRID_ENABLED" Boolean
"_KEYBOARD_SELECTION_ORDER" Text
"_OBJECT_NAME" Text
"_ROW_DRAG_AND_DROP_ENABLED" Boolean
"_ROW_HEADER_RESIZABLE" Boolean
"_ROW_HEADER_SELECTION_ENABLED" Boolean
"_ROW_HEADER_WIDTH" Integer
"_SELECTED_CELLS" Integer
"_SELECTION_POLICY" Text
"_SELECTION_SENSE_ENABLED" Boolean

Visual SCIL Objects
VS_TABLE
"_SORT_ARROW_VISIBLE" Boolean
"_SORT_CRITERIA" Any valid SCIL value
"_SORTING_ENABLED" Boolean
"_VERTICAL_GRID_ENABLED" Boolean
"_VISIBLE" Boolean
42.1.4 Predefined Methods GUID-F33EBFC6-4BF3-4127-A0B6-A4A002AC27B9 v1
Name Type
"_ACCEPT_EDIT" No return value
"_ADD_COLUMN_GROUP" No return value
"_ADD_COLUMNS" No return value
"_ADD_ROW_GROUP" No return value
"_ADD_ROWS" No return value
"_CANCEL_EDIT" No return value
"_DELETE_COLUMNS" No return value
"_DELETE_ROWS" No return value
"_FREEZE_COLUMNS" No return value
"_GET_CELL_BACKGROUND_COLOR" Color
"_GET_CELL_FONT" Font
"_GET_CELL_FOREGROUND_COLOR" Color
"_GET_CELL_HORIZONTAL_JUSTIFICATION" Text
"_GET_CELL_OBJECT_ID" Text
"_GET_CELL_TEXT" Text
"_GET_CELL_VERTICAL_JUSTIFICATION" Text
"_GET_COLUMN_BACKGROUND_COLOR" Color
"_GET_COLUMN_FONT" Font
"_GET_COLUMN_FOREGROUND_COLOR" Color
"_GET_COLUMN_GROUP_BACKGROUND_COLOR" Color
"_GET_COLUMN_GROUP_COUNT" Integer
"_GET_COLUMN_GROUP_FONT" Font
"_GET_COLUMN_GROUP_FOREGROUND_COLOR" Color
"_GET_COLUMN_GROUP_HORIZONTAL_JUSTIFICATION" Text
"_GET_COLUMN_GROUP_OBJECT_ID" Text
"_GET_COLUMN_GROUP_TITLE" Text
"_GET_COLUMN_HORIZONTAL_JUSTIFICATION" Text
"_GET_COLUMN_OBJECT_ID" Text
"_GET_COLUMN_TITLE" Text
"_GET_COLUMN_TITLE_BACKGROUND_COLOR" Color

Visual SCIL Objects
VS_TABLE
"_GET_COLUMN_TITLE_FONT" Font
"_GET_COLUMN_TITLE_FOREGROUND_COLOR" Color
"_GET_COLUMN_TITLE_HORIZONTAL_JUSTIFICATION" Text
"_GET_COLUMN_VERTICAL_JUSTIFICATION" Text
"_GET_COLUMN_WIDTH" Integer
"_GET_EDITED_CELL" Integer
"_GET_ROW_BACKGROUND_COLOR" Color
"_GET_ROW_FONT" Font
"_GET_ROW_FOREGROUND_COLOR" Color
"_GET_ROW_GROUP_BACKGROUND_COLOR" Color
"_GET_ROW_GROUP_COUNT" Integer
"_GET_ROW_GROUP_FONT" Font
"_GET_ROW_GROUP_FOREGROUND_COLOR" Color
"_GET_ROW_GROUP_HORIZONTAL_JUSTIFICATION" Text
"_GET_ROW_GROUP_OBJECT_ID" Text
"_GET_ROW_GROUP_TITLE" Text
"_GET_ROW_HEIGHT" Integer
"_GET_ROW_HORIZONTAL_JUSTIFICATION" Text
"_GET_ROW_OBJECT_ID" Text
"_GET_ROW_TITLE" Text
"_GET_ROW_TITLE_BACKGROUND_COLOR" Color
"_GET_ROW_TITLE_FONT" Font
"_GET_ROW_TITLE_FOREGROUND_COLOR" Color
"_GET_ROW_TITLE_HORIZONTAL_JUSTIFICATION" Text
"_GET_ROW_VERTICAL_JUSTIFICATION" Text
"_IS_CELL_READ_ONLY" Boolean
"_IS_CELL_TEXT_WRAPPED" Boolean
"_IS_COLUMN_READ_ONLY" Boolean
"_IS_COLUMN_RESIZABLE" Boolean
"_IS_COLUMN_SELECTABLE" Boolean
"_IS_COLUMN_SORTING_ENABLED" Boolean
"_IS_COLUMN_TEXT_WRAPPED" Boolean
"_IS_ROW_READ_ONLY" Boolean
"_IS_ROW_RESIZABLE" Boolean
"_IS_ROW_SELECTABLE" Boolean
"_IS_ROW_TEXT_WRAPPED" Boolean
"_SET_CELL_BACKGROUND_COLOR" No return value
"_SET_CELL_EDIT_TYPE_TEXT" No return value
"_SET_CELL_FONT" No return value

Visual SCIL Objects
VS_TABLE
"_SET_CELL_FOREGROUND_COLOR" No return value

"_SET_CELL_HORIZONTAL_JUSTIFICATION" No return value
"_SET_CELL_OBJECT_ID" No return value
"_SET_CELL_READ_ONLY" No return value
"_SET_CELL_TEXT" No return value
"_SET_CELL_TEXT_RANGE" No return value
"_SET_CELL_TEXT_WRAPPED" No return value
"_SET_CELL_VALUE_HANDLER" No return value
"_SET_CELL_VERTICAL_JUSTIFICATION" No return value
"_SET_COLUMN_BACKGROUND_COLOR" No return value
"_SET_COLUMN_EDIT_TYPE_TEXT" No return value
"_SET_COLUMN_FONT" No return value
"_SET_COLUMN_FOREGROUND_COLOR" No return value
"_SET_COLUMN_GROUP_BACKGROUND_COLOR" No return value
"_SET_COLUMN_GROUP_FONT" No return value
"_SET_COLUMN_GROUP_FOREGROUND_COLOR" No return value
"_SET_COLUMN_GROUP_HORIZONTAL_JUSTIFICATION" No return value
"_SET_COLUMN_GROUP_OBJECT_ID" No return value
"_SET_COLUMN_GROUP_TITLE" No return value
"_SET_COLUMN_HORIZONTAL_JUSTIFICATION" No return value
"_SET_COLUMN_OBJECT_ID" No return value
"_SET_COLUMN_READ_ONLY" No return value
"_SET_COLUMN_SORTING" No return value
"_SET_COLUMN_TEXT_WRAPPED" No return value
"_SET_COLUMN_TITLE" No return value
"_SET_COLUMN_TITLE_BACKGROUND_COLOR" No return value
"_SET_COLUMN_TITLE_FONT" No return value
"_SET_COLUMN_TITLE_FOREGROUND_COLOR" No return value
"_SET_COLUMN_TITLE_HORIZONTAL_JUSTIFICATION" No return value
"_SET_COLUMN_TITLE_RESIZABLE" No return value
"_SET_COLUMN_TITLE_SELECTABLE" No return value
"_SET_COLUMN_VALUE_HANDLER" No return value
"_SET_COLUMN_VERTICAL_JUSTIFICATION" No return value
"_SET_COLUMN_WIDTH" No return value
"_SET_ROW_BACKGROUND_COLOR" No return value
"_SET_ROW_EDIT_TYPE_TEXT" No return value
"_SET_ROW_FONT" No return value
"_SET_ROW_FOREGROUND_COLOR" No return value
"_SET_ROW_GROUP_BACKGROUND_COLOR" No return value
"_SET_ROW_GROUP_FONT" No return value
"_SET_ROW_GROUP_FOREGROUND_COLOR" No return value
"_SET_ROW_GROUP_HORIZONTAL_JUSTIFICATION" No return value
"_SET_ROW_GROUP_OBJECT_ID" No return value
"_SET_ROW_GROUP_TITLE" No return value

Visual SCIL Objects
VS_TABLE
"_SET_ROW_HEIGHT" No return value

"_SET_ROW_HORIZONTAL_JUSTIFICATION" No return value
"_SET_ROW_OBJECT_ID" No return value
"_SET_ROW_READ_ONLY" No return value
"_SET_ROW_TEXT_WRAPPED" No return value
"_SET_ROW_TITLE" No return value
"_SET_ROW_TITLE_BACKGROUND_COLOR" No return value
"_SET_ROW_TITLE_FONT" No return value
"_SET_ROW_TITLE_FOREGROUND_COLOR" No return value
"_SET_ROW_TITLE_HORIZONTAL_JUSTIFICATION" No return value
"_SET_ROW_TITLE_RESIZABLE" No return value
"_SET_ROW_TITLE_SELECTABLE" No return value
"_SET_ROW_VALUE_HANDLER" No return value
"_SET_ROW_VERTICAL_JUSTIFICATION" No return value
"_SORT" No return value
"_UNFREEZE_COLUMNS" No return value
42.2 Details GUID-515A1163-B1EE-47B5-AC8C-628483138CAC v1
42.2.1 Action Attributes GUID-EFAC487D-2C99-4DCA-95F9-FD06ACB0312B v1
_CELL_EDITING_ACCEPTED
Setting this attribute specifies the action method CELL_EDITING_ACCEPTED.
_CELL_EDITING_CANCELLED
Setting this attribute specifies the action method CELL_EDITING_CANCELLED.
_CELL_EDITING_STARTED
Setting this attribute specifies the action method CELL_EDITING_STARTED
_COLUMN_TITLE_CLICKED
Setting this attribute specifies the action method COLUMN_TITLE_CLICKED.
_COLUMN_TITLE_DOUBLE_CLICKED
Setting this attribute specifies the action method COLUMN_TITLE_DOUBLE_CLICKED.
_DRAGGED_AND_DROPPED
Setting this attribute specifies the action method DRAGGED_AND_DROPPED.

Visual SCIL Objects
VS_TABLE
_FOCUSED_CELL_CHANGED
Setting this attribute specifies the action method FOCUSED_CELL_CHANGED.
_NOTIFY
Example:
_TOOLTIP_IS_SHOWN
_SELECTION_HAS_CHANGED
Setting this attribute specifies the action method SELECTION_HAS_CHANGED.
42.2.2 Action Methods GUID-D17B25BE-4B9E-45B5-A266-4A7A043BB64B v1
CELL_EDITING_ACCEPTED
This action method is executed whenever the user has accepted a new value of an edited cell. Two
arguments are passed to this action method specifying the indexes of the cell. The arguments are
integer values specifying ROW and COLUMN.
CELL_EDITING_CANCELLED
This action method is executed whenever the user cancels the editing of a cell. Two arguments are
passed to this action method specifying the indexes of the cell. The arguments are integer values
specifying ROW and COLUMN.
CELL_EDITING_STARTED
This action method is executed whenever the user starts editing a cell. Two arguments are passed to
this action method specifying the indexes of the cell. The arguments are integer values specifying
ROW and COLUMN.
COLUMN_TITLE_CLICKED
This method is executed whenever the user clicks a column title. One argument is passed to this
action method specifying the number of the column title, which was clicked. The argument is an
integer value specifying COLUMN NUMBER.

Visual SCIL Objects
VS_TABLE
COLUMN_TITLE_DOUBLE_CLICKED
This method is executed whenever the user double-clicks a column title. One argument is passed to
this action method specifying the number of the column title that was double-clicked. The argument is
an integer value specifying COLUMN NUMBER.
DRAGGED_AND_DROPPED
This method is executed whenever the user has dragged and dropped a column/row or multiple
columns/rows. Five arguments are passed to these action methods: START_NUM = previous
column/row order number, COUNT = number of columns/rows been dragged, LEVEL = 0 for a single
column/row, otherwise is a group level, END_NUM = new order number of the column/row, TYPE =
text ROW or COLUMN specifies the moved items.
FOCUSED_CELL_CHANGED
This method is executed whenever the user has changed the focused cell with the mouse or arrow
keys. Two arguments are passed to this action method specifying the indexes of the new focused
cell. The arguments are integer values specifying ROW and COLUMN.
SELECTION_HAS_CHANGED
This method is executed whenever the selection is going to be changed, is changing and has
changed. One argument is passed to this action method. The argument can be used to detect how
the selection is changing.
Example:
@state=argument(1)
#case %arg
#when 1 @stateText=“Selection is going to change“
#when 2 @stateText=“Selection is changing“
#when 3 @stateText=“Selection has changed“
#otherwise @stateText=“Selection error“
#case_end
TOOLTIP_IS_SHOWN
42.2.3 Predefined Attributes GUID-1C0C6483-F3CC-489D-8757-3398DF0A030D v1
_ATTRIBUTE_NAMES

Visual SCIL Objects
VS_TABLE
_AUTO_EDIT_ENABLED
This attribute will specify how to enter edit mode. If this attribute is TRUE, the editing will start
automatically when entering an editable cell. If this attribute is FALSE, the user must press ENTER to
start editing. This attribute only affects keyboard handling.

Data type: Boolean
Specifies whether the table scrolls automatically or not when the user drags the mouse outside of the
area currently visible in the table.

Data type: Boolean
Default value: TRUE
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE
Data type: Boolean
Example:
_COLUMN_COUNT
Specifies the number of used columns in a table.
Setting this attribute to zero will clear all columns and their properties. In this case,
also the following properties and attributes are initialized to default values: default
column width, default column title, _COLUMN_DRAG_AND_DROP_ENABLED,
_COLUMN_HEADER_RESIZABLE, _COLUMN_HEADER_SELECTABLE,
_EXTEND_COLUMN_SELECTION_ENABLED, _HAS_COLUMN_HEADER,
_SORTING_ENABLED.

Visual SCIL Objects
VS_TABLE

Data type: Integer
Default value: 0
_COLUMN_DRAG_AND_DROP_ENABLED
This attribute specifies whether dragging and dropping columns or column groups is enabled. If this
attribute is TRUE, the user can drag and drop a column or a column group. If this attribute is FALSE,
the user cannot drag and drop columns or column groups.

Data type: Boolean
_COLUMN_HEADER_RESIZABLE
Specifies whether the user can resize column titles and groups or not.

Data type: Boolean
Default value: TRUE
_COLUMN_HEADER_SELECTION_ENABLED
Specifies the column header behavior. This attribute affects all column titles and column groups. If
this attribute is TRUE, clicking a column title will select the entire column.

Data type: Boolean
_DOUBLE_CLICK_EDIT_ENABLED
This attribute will specify how to enter edit mode. If this attribute is TRUE, the user must double-click
a cell to start editing. If this attribute is FALSE, the user needs to click a cell only once to start editing.
This attribute only affects mouse handling.

Data type: Boolean
Default value: TRUE
_DRAWING_SELECTION_ENABLED
Specifies whether a drawing selection is used or not. If _DRAWING_SELECTION_ENABLED is set
to TRUE, all the table cells that were under the cursor when dragging the mouse became selected. If
_DRAWING_SELECTION_ENABLED is set to FALSE, the selected area is rectangular.

Visual SCIL Objects
VS_TABLE

Data type: Boolean
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_EXTEND_COLUMN_SELECTION_ENABLED
When this attribute is set to TRUE, the entire column is selected when any of the cells in the column
is selected. The _SELECTION_POLICY attribute works as before, except that it operates on columns
instead of single cells. Only one column can be selected when _SELECTION_POLICY is
ONE_ONLY_SELECTION.

Data type: Boolean
_EXTEND_ROW_SELECTION_ENABLED
When this attribute is set to TRUE, the entire row is selected when any of the cells in the row is
selected. The SELECTION_POLICY attribute works as before, except that it operates on rows
instead of single cells. Only one row can be selected when SELECTION_POLICY is
ONE_ONLY_SELECTION.

Data type: Boolean
_FILE_REVISION
_FIRST_VISIBLE_COLUMN
Contains the index of the leftmost visible column.

Visual SCIL Objects
VS_TABLE

Data type: Integer
Default value: 1
Access: Read-only
_FIRST_VISIBLE_ROW
Contains the index of the topmost visible row.

Data type: Integer
Default value: 1
Access: Read-only
_FOCUSABLE

Data type: Boolean
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FOCUSED_CELL
Specifies the current focused cell. When the user is using keyboard to travel around the table, the
_FOCUSED_CELL is changing. The _FOCUSED_CELL can sometimes be one of
_SELECTED_CELLS.

Data type: Integer

Visual SCIL Objects
VS_TABLE
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
view as if you grabbed it, so that the scrolling of the view and the movement of the mouse are
synchronous.

Data type: Boolean
_HAS_BORDER
Specifies the border of an entire VS_TABLE object. If this attribute is set to TRUE, the table has a
border. If this attribute is set to FALSE, the table does not have a border.

Data type: Boolean
Default value: TRUE
_HAS_COLUMN_HEADER
Specifies the column header visibility. If this attribute is TRUE, column header is visible. Setting this
attribute to FALSE will hide the column header (all column titles and column groups).

Data type: Boolean
Default value: TRUE

Visual SCIL Objects
VS_TABLE
_HAS_ROW_HEADER
Specifies the row header visibility. If this attribute is TRUE, row header is visible. Setting this attribute
to FALSE will hide the row header (all row titles and row groups).

Data type: Boolean
Default value: TRUE
_HORIZONTAL_GRID_ENABLED
Specifies whether a horizontal grid is enabled or not.

Data type: Boolean
Default value: TRUE

Data type: Boolean
Default value: TRUE
Specifies whether a table allows keyboard selection through keyboard focus. When a table has focus
and a key is pressed, the selected cell of the table changes to the first one that starts with the
character pressed. If the characters are pressed with delay smaller than one second, the characters
are collected to a string and a matching cell text is seached.

Data type: Boolean
Default value: TRUE
_KEYBOARD_SELECTION_ORDER
Specifies the searching order of matching cell texts after pressing of character keys. It has meaning
only if _KEYBOARD_SELECTION_ENABLED attribute value is TRUE. Possible values are
ROW_MAJOR and COLUMN_MAJOR. In the first case, when a character key is pressed, all rows of
the first column are scanned from top to bottom then all rows of the second column and so forth. In
the second case the scanning occurs by all columns of the first row then by all columns of the second
row and so forth.

Visual SCIL Objects
VS_TABLE

ROW_MAJOR or COLUMN_MAJOR
Data type: Text
Default value: "ROW_MAJOR"
Specifies if the keyboard traversal is used in table cells or not. If the value is TRUE, the VS_TABLE
cell with keyboard arrow keys. If the value is FALSE, the VS_TABLE will only handle mouse events.
In this case, theht user can make selections or change the focused cell only with mouse.

Data type: Boolean
Default value: TRUE
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
the object.

Example:
_ROW_COUNT
Specifies the number of used rows in a table.
Setting this attribute to zero will clear all rows and their properties. In this case, the
following properties and attributes are also initialized to default values: default row
title, default row height, _EXTEND_ROW_SELECTION_ENABLED,
_HAS_ROW_HEADER, _ROW_DRAG_AND_DROP_ENABLED,
_ROW_HEADER_RESIZABLE, _ROW_HEADER_SELECTABLE,
_SORTING_ENABLED, _ROW_HEADER_WIDTH.

Visual SCIL Objects
VS_TABLE

Data type: Integer
Default value: 0
_ROW_DRAG_AND_DROP_ENABLED
This attribute specifies whether dragging and dropping of rows or row groups is enabled. If this
attribute is TRUE, the user can drag and drop a row or a row group. If this attribute is FALSE, the
user cannot drag and drop rows or row groups.

Data type: Boolean
_ROW_HEADER_RESIZABLE
Specifies whether the user can resize row titles and groups or not.

Data type: Boolean
Default value: TRUE
_ROW_HEADER_SELECTION_ENABLED
Specifies the row header behavior. This attribute affects to all row titles and row groups. If this
attribute is TRUE, clicking a row title will select the entire row.

Data type: Boolean
_ROW_HEADER_WIDTH
Specifies the width of the row header as a percentage value of the VS_TABLE width. The calculation
of the actual VS_TABLE row header width is done so that the VS_TABLE keeps at least a sliver of a
cell visible. For example, the width of the VS_TABLE is 200. After .SET
MY_TABLE._ROW_HEADER_WIDTH=50, the header width is 100 (in pixels).

Data type: Integer
Default value: 25
_SCIL_GEOMETRY

Visual SCIL Objects
VS_TABLE
_SELECTED_CELLS
Specifies the selected cells in a table. Note that if the attribute _SELECTION_POLICY is set to
ONE_ONLY_SELECTION, only one cell can be selected at a time.

Data type: Integer
_SELECTED_ROW
Specifies the selected row number.
Description: An integer
Data type: Integer
Default value: 0
Example:
@rownumber = my_table._selected_row
.set my_table._selected_row = 5
_SELECTION_POLICY
Specifies the selection policy in a table.

FREE_SELECTION, ONE_ONLY_SELECTION,
RECTANGULAR_SELECTION and NO_SELECTION.
Data type: Text
Default value: "ONE_ONLY_SELECTION"
_SELECTION_SENSE_ENABLED
If _SELECTION_SENSE_ENABLED is TRUE and the user adjust-clicks on selected cells, the cells
are removed from the selection. When _SELECTION_SENSE_ENABLED is FALSE, clicking cells
with the mouse only adds cells to the selection. Note that the implementation of adjust-click may vary
between platforms. On the Windows platform, adjust-click is implemented as CTRL+left mouse
button.

Data type: Boolean
Default value: TRUE
_SORT_ARROW_VISIBLE
Specifies whether the arrow showing the sort order will be visible or not.

Visual SCIL Objects
VS_TABLE

Data type: Boolean
_SORT_CRITERIA
This attribute specifies the sorting criteria of a table. Sorting can be based on one or multiple
columns. The sorting criterion is an ordered vector, which contains a sorting keys. The sorting key is
a vector of two elements. This element specifies the column and the sort order of that column. Sort
order is either ASCENDING, DESCENDING or NO_ORDER.
Description: Any valid SCIL value.

Data type: Any valid SCIL value
Example:
.SET MY_TABLE._SORT_CRITERIA=vector((3,“ASCENDING“), (1,“DESCENDING“))
MY_TABLE._SORT
This means that the column 3 is the first sorting key and it is sorted in
ascending order and the second sorting key is the column 1 and it is
sorted in descending order. Also this means that for the columns 1 and 3
the sorting is enabled.
_SORTING_ENABLED
Specifies the default sorting. By default, sorting is disabled for a table.
Setting this attribute to TRUE requires that there are some rows but no groups in the
table.

Data type: Boolean
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text
Example:

Visual SCIL Objects
VS_TABLE
_VARIABLE_NAMES
_VERTICAL_GRID_ENABLED
Specifies whether a vertical grid is enabled or not.

Data type: Boolean
Default value: TRUE

Data type: Boolean
Default value: TRUE
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
42.2.4 Predefined Methods GUID-DA471A75-652D-4A72-8E69-EF00671C7D8B v1
_ACCEPT_EDIT
Terminates any active cell editing. After this call, a new value has been stored to the cell.
_ADD_COLUMN_GROUP
This method adds a column group to the given level LEVEL on a table. All columns in range
[START_COLUMN, END_COLUMN] belong to this column group.

Visual SCIL Objects
VS_TABLE

Parameter(s)
START_COLUMN Integer
END_COLUMN Integer
LEVEL Integer
An integer value.
_ADD_COLUMNS
Inserts COUNT columns before (AFTER=FALSE) of after (AFTER=TRUE) column with number
START_COLUMN. If the column START_COLUMN is in a column group, new columns are added to
the same group.

Parameter(s)
AFTER Boolean
COUNT Integer
An integer value.
_ADD_ROW_GROUP
This method adds a row group to the given level LEVEL to the table. Rows in range [START_ROW,
END_ROW] belongs to this row group.

Parameter(s)
START_ROW Integer
END_ROW Integer
LEVEL Integer
An integer value.
_ADD_ROWS
Inserts COUNT rows before (AFTER=FALSE) of after (AFTER=TRUE) row with number
START_ROW. If the row START_ROW is in a row group, new rows are added to the same group.

Parameter(s)
START_ROW Integer
AFTER Boolean
COUNT Integer
An integer value.

Visual SCIL Objects
VS_TABLE
_CANCEL_EDIT
Terminates any active cell editing. The cell's value is returned to the value before the editing started.
_DELETE_COLUMNS
Deletes columns as a range from START_COLUMN to END_COLUMN
This attribute also deletes the corresponding column groups.

Parameter(s)
END_COLUMN Integer
_DELETE_ROWS
Deletes rows as a range from START_ROW to END_ROW.
This attribute also deletes the corresponding row group.

Parameter(s)
START_ROW Integer
END_ROW Integer
_FLAG_FOR_EXECUTION
_FREEZE_COLUMNS
This method freezes all columns from 1 to END_COLUMN. These columns always become visible
independently of the scrolling process. These columns must not belong to any group, or the group
these columns belong to must not contain other columns. Otherwise, this function generates an
exception.

Parameter(s)
END_COLUMN Integer
_GET_CELL_BACKGROUND_COLOR
Returns the background color being used for the cell specified by the ROW and COLUMN
arguments.

Visual SCIL Objects
VS_TABLE
Return value data type: Color

Parameter(s)
ROW Integer
COLUMN Integer
_GET_CELL_FONT
Returns the font being used for the cell specified by the ROW and COLUMN arguments.
Return value data type: Font

Parameter(s)
ROW Integer
COLUMN Integer
_GET_CELL_FOREGROUND_COLOR
Returns the foreground color being used for the cell specified by the ROW and COLUMN arguments.

Parameter(s)
ROW Integer
COLUMN Integer
_GET_CELL_HORIZONTAL_JUSTIFICATION
Returns the horizontal justification being used for the cell specified by the ROW and COLUMN
arguments.

Parameter(s)
ROW Integer
COLUMN Integer
_GET_CELL_OBJECT_ID
Returns the object id saved in the cell specified by the ROW and COLUMN arguments.

Parameter(s)
ROW Integer
COLUMN Integer

Visual SCIL Objects
VS_TABLE
_GET_CELL_TEXT
Returns the current value of the cell specified by the ROW and COLUMN arguments.

Parameter(s)
ROW Integer
COLUMN Integer
_GET_CELL_TEXT_RANGE
Returns the text vector ranging from the given cell in a table. The text area can be fetched
horizontally or vertically.
Parameter(s)
ROW Integer
COLUMN Integer
DIRECTION Text
COUNT Integer
An integer value.
Example:
@VECTOR = MY_TABLE._GET_CELL_TEXT_RANGE(1, 1, “HORIZONTAL“, 10)
_GET_CELL_VERTICAL_JUSTIFICATION
Returns the vertical justification being used for the cell specified by the ROW and COLUMN
arguments.

Parameter(s)
ROW Integer
COLUMN Integer
_GET_COLUMN_BACKGROUND_COLOR
Returns the background color being used for the column specified by argument COLUMN.

Parameter(s)
COLUMN Integer
_GET_COLUMN_FONT
Returns the font being used for the column specified by argument COLUMN.

Visual SCIL Objects
VS_TABLE

Parameter(s)
COLUMN Integer
_GET_COLUMN_FOREGROUND_COLOR
Returns the foreground color being used for the column specified by argument COLUMN.

Parameter(s)
COLUMN Integer
_GET_COLUMN_GROUP_BACKGROUND_COLOR
Returns the background color being used for the column group specified by arguments LEVEL and
ORDER_NUMBER.

Parameter(s)
LEVEL Integer
ORDER_NUMBER Integer
_GET_COLUMN_GROUP_COUNT
Returns the count of column groups at given level LEVEL. Note that this attribute returns the value -1
if there is no group at all, or zero (0) if there are groups in other levels than LEVEL.

Parameter(s)
LEVEL Integer
_GET_COLUMN_GROUP_FONT
Returns the font being used for the column group specified by arguments LEVEL and
ORDER_NUMBER.

Parameter(s)
LEVEL Integer
_GET_COLUMN_GROUP_FOREGROUND_COLOR
Returns the foreground color being used for the column group specified by arguments LEVEL and
ORDER_NUMBER.

Visual SCIL Objects
VS_TABLE

Parameter(s)
LEVEL Integer
_GET_COLUMN_GROUP_HORIZONTAL_JUSTIFICATION
Returns the horizontal justification being used for the column group specified by arguments LEVEL
and ORDER_NUMBER.

Parameter(s)
LEVEL Integer
_GET_COLUMN_GROUP_OBJECT_ID
Returns the object id saved in the column group specified by arguments LEVEL and
ORDER_NUMBER.

Parameter(s)
LEVEL Integer
_GET_COLUMN_GROUP_TITLE
Returns the title of the column group specified by arguments LEVEL and ORDER_NUMBER.

Parameter(s)
LEVEL Integer
_GET_COLUMN_HORIZONTAL_JUSTIFICATION
Returns the horizontal justification being used for drawing the text of the COLUMN.

Parameter(s)
COLUMN Integer
_GET_COLUMN_OBJECT_ID
Returns the object id saved in the column COLUMN.

Visual SCIL Objects
VS_TABLE

Parameter(s)
COLUMN Integer
_GET_COLUMN_TITLE
Returns the title of the column COLUMN.

Parameter(s)
COLUMN Integer
_GET_COLUMN_TITLE_BACKGROUND_COLOR
Returns the column title being used for the column title specified by the column argument, as well as
the color of the top left cell.
In the example below, the top left cell is set to the color of the first column title's background color.
GUID-B2D60C1E-4F9F-40A8-BE80-33D49E1E043E V1 EN-US
Figure 1: Column title background color

Parameter(s)
COLUMN Integer
_GET_COLUMN_TITLE_FONT
Returns the font being used for the column title specified by the COLUMN argument.

Parameter(s)
COLUMN Integer
_GET_COLUMN_TITLE_FOREGROUND_COLOR
Returns the foreground color being used for the column title specified by the COLUMN argument.

Parameter(s)
COLUMN Integer

Visual SCIL Objects
VS_TABLE
_GET_COLUMN_TITLE_HORIZONTAL_JUSTIFICATION
Returns the horizontal justification being used for the column title specified by the COLUMN
argument.

Parameter(s)
COLUMN Integer
_GET_COLUMN_VERTICAL_JUSTIFICATION
Returns the vertical justification being used for the column specified by COLUMN argument.

Parameter(s)
COLUMN Integer
_GET_COLUMN_WIDTH
Returns the width of the column COLUMN.

Parameter(s)
COLUMN Integer
_GET_EDITED_CELL
Returns a vector containing a vector with the indexes (row and column) of the currently edited cell in
a table (eg. vector((%i_Row,%i_Col))). When no cell is being edited, this attribute returns an empty
vector.
Example:
@VECTOR = MY_TABLE._GET_EDITED_CELL
_GET_HELP
_GET_ROW_BACKGROUND_COLOR
Parameter(s)
ROW Integer
Returns the background color being used for the row ROW.
_GET_ROW_FONT
Returns the font being used for the row ROW.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
_GET_ROW_FOREGROUND_COLOR
Returns the foreground color being used for the row ROW.

Parameter(s)
ROW Integer
_GET_ROW_GROUP_BACKGROUND_COLOR
Returns the background color being used for the row group specified by arguments LEVEL and
ORDER_NUMBER.

Parameter(s)
LEVEL Integer
_GET_ROW_GROUP_COUNT
Returns the count of row groups at given level LEVEL. Note that this attribute returns the value -1 if
there is no group at all, or zero (0) if there are groups in other levels than LEVEL.

Parameter(s)
LEVEL Integer
_GET_ROW_GROUP_FONT
Returns the font being used for the row group title specified by arguments LEVEL and
ORDER_NUMBER.

Parameter(s)
LEVEL Integer
_GET_ROW_GROUP_FOREGROUND_COLOR
Returns the foreground color used for the row group title specified by arguments LEVEL and
ORDER_NUMBER.

Visual SCIL Objects
VS_TABLE

Parameter(s)
LEVEL Integer
_GET_ROW_GROUP_HORIZONTAL_JUSTIFICATION
Returns the horizontal justification used for the row group title specified by arguments LEVEL and
ORDER_NUMBER.

Parameter(s)
LEVEL Integer
_GET_ROW_GROUP_OBJECT_ID
Returns the object id saved in the row group specified by arguments LEVEL and ORDER_NUMBER.

Parameter(s)
LEVEL Integer
_GET_ROW_GROUP_TITLE
Returns the title of the row group specified by arguments LEVEL and ORDER_NUMBER.

Parameter(s)
LEVEL Integer
_GET_ROW_HEIGHT
Returns the height of the row ROW.

Parameter(s)
ROW Integer
_GET_ROW_HORIZONTAL_JUSTIFICATION
Returns the horizontal justification of the row ROW.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
_GET_ROW_OBJECT_ID
Returns the object id saved in the row ROW.

Parameter(s)
ROW Integer
_GET_ROW_TITLE
Returns the title of the row ROW.

Parameter(s)
ROW Integer
_GET_ROW_TITLE_BACKGROUND_COLOR
Returns the background color being used for the row title specified by the ROW argument.

Parameter(s)
ROW Integer
_GET_ROW_TITLE_FONT
Returns the font being used for the row title specified by the ROW argument.

Parameter(s)
ROW Integer
_GET_ROW_TITLE_FOREGROUND_COLOR
Returns the foreground color being used for the row title specified by the ROW argument.

Parameter(s)
ROW Integer
_GET_ROW_TITLE_HORIZONTAL_JUSTIFICATION
Returns the horizontal justification being used for the row title specified by the ROW argument.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
_GET_ROW_VERTICAL_JUSTIFICATION
Returns the vertical justification being used for the row specified by the ROW argument.

Parameter(s)
ROW Integer
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_IS_CELL_READ_ONLY
Returns the value being used to determine whether the cell specified by the ROW and COLUMN
arguments is considered read-only or not.

Parameter(s)
ROW Integer
COLUMN Integer
_IS_CELL_TEXT_WRAPPED
Returns the value being used to determine whether the cell text specified by the ROW and COLUMN
arguments is considered wrapped or not.

Parameter(s)
ROW Integer
COLUMN Integer
_IS_COLUMN_READ_ONLY
Returns the value being used to determine whether the specified COLUMN is considered read-only
or not.

Visual SCIL Objects
VS_TABLE

Parameter(s)
COLUMN Integer
_IS_COLUMN_RESIZABLE
Returns TRUE if the column title of the column COLUMN is resizable, otherwise returns FALSE.

Parameter(s)
COLUMN Integer
_IS_COLUMN_SELECTABLE
Returns TRUE if the column title of the column COLUMN is selectable, otherwise returns FALSE.

Parameter(s)
COLUMN Integer
_IS_COLUMN_SORTING_ENABLED
Is sorting enabled or disabled for column COLUMN.

Parameter(s)
COLUMN Integer
_IS_COLUMN_TEXT_WRAPPED
Returns the value being used to determine whether or not the column text specified by the COLUMN
argument is considered wrapped.

Parameter(s)
COLUMN Integer
_IS_ROW_READ_ONLY
Returns the value being used to determine whether the specified ROW is considered read-only or
not.

Parameter(s)
ROW Integer

Visual SCIL Objects
VS_TABLE
_IS_ROW_RESIZABLE
Returns the value being used to determine whether the specified ROW title is considered resizable or
not.

Parameter(s)
ROW Integer
_IS_ROW_SELECTABLE
Returns the value being used to determine whether the specified ROW title is considered selectable
or not.
Return value data type: Bolean

Parameter(s)
ROW Integer
_IS_ROW_TEXT_WRAPPED
Returns the value being used to determine whether the specified ROW texts are considered wrapped
or not.

Parameter(s)
ROW Integer
Scrolls the table so that the specified cell is at least partly visible.

Parameter(s)
ROW Integer
COLUMN Integer
Scrolls the table so that the text that is currently selected is at least partly visible.
_SET_CELL_BACKGROUND_COLOR
Sets the background color of the cell specified by the ROW and COLUMN to the COLOR.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
COLUMN Integer
COLOR Color
_SET_CELL_EDIT_TYPE_TEXT
This method adds a default text edit type to a cell described by parameters ROW and COLUMN.

Parameter(s)
ROW Integer
COLUMN Integer
IS_ONE_LINE Boolean
WRAP_ENABLED Boolean
TEXT Text
_SET_CELL_FONT
Sets the font of the cell specified by the ROW and COLUMN to the FONT.

Parameter(s)
ROW Integer
COLUMN Integer
FONT Font
A font as referenced within SCIL.
_SET_CELL_FOREGROUND_COLOR
Sets the foreground color of the cell specified by the ROW and COLUMN to the COLOR.

Parameter(s)
ROW Integer
COLUMN Integer
COLOR Color

Visual SCIL Objects
VS_TABLE
_SET_CELL_HORIZONTAL_JUSTIFICATION
Sets the horizontal justification of the cell specified by the ROW and COLUMN to the
JUSTIFICATION.

Parameter(s)
ROW Integer
COLUMN Integer
JUSTIFICATION Text
DEFAULT, LEFT_JUSTIFY, RIGHT_JUSTIFY or
CENTER_JUSTIFY
_SET_CELL_OBJECT_ID
Sets the identification string of the specified cell. The identification can be any valid text string. The
OBJECT_ID is not used internally in any way, so the SCIL programmer may use it freely.

Parameter(s)
ROW Integer
COLUMN Integer
OBJECT_ID Text
_SET_CELL_READ_ONLY
Sets the cell specified by the ROW and COLUMN to be READ_ONLY. If READ_ONLY is TRUE, the
cell is read only. If READ_ONLY is FALSE, the cell is editable.

Parameter(s)
ROW Integer
COLUMN Integer
READ_ONLY Boolean
_SET_CELL_TEXT
Sets the text of the given cell in the table. The table is automatically expanded if text is set into a row
or column that does not exist.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
COLUMN Integer
TEXT Text
Example:
MY_TABLE._SET_CELL_TEXT(1, 1, “Inserted Text“)
_SET_CELL_TEXT_RANGE
Sets the text area ranging from a given cell in the table. The text area can be set horizontally or
vertically. The table is automatically expanded if text area is set into a row or column that does not
exist. The table can be cleared by setting the attribute _ROW_COUNT to zero.

Parameter(s)
ROW Integer
COLUMN Integer
DIRECTION Text
TEXT_VECTOR Vector
_SET_CELL_TEXT_WRAPPED
Sets the wrapping of the cell text specified by ROW and COLUMN.

Parameter(s)
ROW Integer
COLUMN Integer
WRAPPED Boolean
_SET_CELL_VALUE_HANDLER
Defines a user defined value handler for the cell. See programming guidelines from SYS600 Visual
SCIL Application Design.
Edit and view objects must be created or loaded as childs of an ancestor object of
the table in the objects tree. If a sufficient time is passed between creating/loading
the object and setting it as value handler, the object should be made invisible and
disabled if it is not expected to appear on the dialog and take mouse and keyboard
events. One object can be set as edit or view object only for one cell, row or column.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
COLUMN Integer
VIEW_OBJECT Dialog Item
EDIT_OBJECT Dialog Item
Example:
.LOAD ROOT\ A=VS_COMBO_POPDOWN(-
“MYTYPES.VSO“,“EDIT1_OBJECT“)
.LOAD ROOT\ B=VS_TEXT(-
“MYTYPES.VSO“,“VIEW1_OBJECT“)
ROOT\ MY_TABLE._SET_CELL_VALUE_HANDLER(1,1, “ROOT\ B“, “ROOT\ A“)
_SET_CELL_VERTICAL_JUSTIFICATION
Sets the vertical justification of the cell specified by the ROW and COLUMN to the JUSTIFICATION.

Parameter(s)
ROW Integer
COLUMN Integer
JUSTIFICATION Text
BOTTOM_JUSTIFY,TOP_JUSTIFY or
CENTER_JUSTIFY
_SET_COLUMN_BACKGROUND_COLOR
Sets the background color being used for the whole column specified by argument COLUMN to color
COLOR.

Parameter(s)
COLUMN Integer
COLOR Color
_SET_COLUMN_EDIT_TYPE_TEXT
This method adds a default text edit type to a column described by parameter COLUMN.

Visual SCIL Objects
VS_TABLE

Parameter(s)
COLUMN Integer
IS_ONE_LINE Boolean
TEXT Text
_SET_COLUMN_FONT
Sets the font being used for the whole column specified by argument COLUMN to FONT.

Parameter(s)
COLUMN Integer
FONT Font
_SET_COLUMN_FOREGROUND_COLOR
Sets the foreground color being used for the whole column specified by argument COLUMN to color
COLOR.

Parameter(s)
COLUMN Integer
COLOR Color
_SET_COLUMN_GROUP_BACKGROUND_COLOR
Sets the background color being used for the column group specified by arguments LEVEL and
ORDER_NUMBER to COLOR.

Parameter(s)
LEVEL Integer
COLOR Color
_SET_COLUMN_GROUP_FONT
Sets the font being used for the column group specified by arguments LEVEL and
ORDER_NUMBER to FONT.

Visual SCIL Objects
VS_TABLE

Parameter(s)
LEVEL Integer
FONT Font
_SET_COLUMN_GROUP_FOREGROUND_COLOR
Sets the foreground color being used for the column group specified by arguments LEVEL and

Parameter(s)
LEVEL Integer
COLOR Color
_SET_COLUMN_GROUP_HORIZONTAL_JUSTIFICATION
Sets the horizontal justification being used for the column group specified by arguments LEVEL and
ORDER_NUMBER to JUSTIFICATION.

Parameter(s)
LEVEL Integer
JUSTIFICATION Text
CENTER_JUSTIFY
_SET_COLUMN_GROUP_OBJECT_ID
Sets the identification string of the specified column group. The identification can be any valid text
string. The OBJECT_ID is not used internally in any way, so the SCIL programmer may use it freely.

Parameter(s)
LEVEL Integer
OBJECT_ID Text

Visual SCIL Objects
VS_TABLE
_SET_COLUMN_GROUP_TITLE
Sets the title of the column group specified by arguments LEVEL and ORDER_NUMBER to TITLE. It
is possible to use automatic numbering in the column group. The title can have “%d“ to show the
index of the group and “%l“ to show the level of the group.

Parameter(s)
LEVEL Integer
TITLE Text
Example:
This example shows how to use automatic numbering of a column group:
._add_column_group(1,2,1)
._set_column_group_title(1,1,“Level %l, Index %d“)
_SET_COLUMN_HORIZONTAL_JUSTIFICATION
Sets the horizontal justification being used for drawing the text of the COLUMN to JUSTIFICATION.
The JUSTIFICATION is a text string containing one of the following keywords: DEFAULT,
LEFT_JUSTIFY, RIGHT_JUSTIFY or CENTER_JUSTIFY.

Parameter(s)
COLUMN Integer
JUSTIFICATION Text
CENTER_JUSTIFY
_SET_COLUMN_OBJECT_ID
Sets the identification string of the specified column. The identification can be any valid text string.
The OBJECT_ID is not used internally in any way, so the SCIL programmer may use it freely.

Parameter(s)
COLUMN Integer
OBJECT_ID Text
_SET_COLUMN_READ_ONLY
Sets the specified column COLUMN to be read only if the READ_ONLY argument is TRUE,
otherwise the column is editable. By default, all columns are read only.

Visual SCIL Objects
VS_TABLE

Parameter(s)
COLUMN Integer
READ_ONLY Boolean
_SET_COLUMN_SORTING
Sets the specified column COLUMN to be sortable, if the SORTING_ENABLED argument is TRUE.
By default, sorting is disabled for all columns.
Sorting is disabled, if there is column or row groups.

Parameter(s)
COLUMN Integer
SORTING_ENABLED Boolean
_SET_COLUMN_TEXT_WRAPPED
Sets the specified column to be wrapped if the WRAPPED argument is TRUE, otherwise the column
is not wrapped. By default, columns are not wrapped.

Parameter(s)
COLUMN Integer
WRAPPED Boolean
_SET_COLUMN_TITLE
Sets the title of the specified column COLUMN to TITLE. The title is a string to be displayed in the
column header if the header is visible.

Parameter(s)
COLUMN Integer
TITLE Text
_SET_COLUMN_TITLE_BACKGROUND_COLOR
Sets the background color of the specified column title COLUMN to the specified color COLOR.
Setting this color also sets the color of the Top Left Cell in VS_TABLE.

Visual SCIL Objects
VS_TABLE

Parameter(s)
COLUMN Integer
COLOR Color
_SET_COLUMN_TITLE_FONT
Sets the font of the specified column COLUMN to the specified font FONT.

Parameter(s)
COLUMN Integer
FONT Font
_SET_COLUMN_TITLE_FOREGROUND_COLOR
Sets the foreground color of the specified column title COLUMN to the specified color COLOR.

Parameter(s)
COLUMN Integer
COLOR Color
_SET_COLUMN_TITLE_HORIZONTAL_JUSTIFICATION
Sets the horizontal justification being used for the column title specified by the COLUMN argument.
The JUSTICATION is a text string containing one of the following keywords: DEFAULT,
LEFT_JUSTIFY, RIGHT_JUSTIFY or CENTER_JUSTIFY.

Parameter(s)
COLUMN Integer
JUSTIFICATION Text
CENTER_JUSTIFY
_SET_COLUMN_TITLE_RESIZABLE
Sets the behavior of the column title specified by COLUMN. If RESIZABLE is TRUE, the user can
resize the column width with the cursor.

Visual SCIL Objects
VS_TABLE

Parameter(s)
COLUMN Integer
RESIZABLE Boolean
_SET_COLUMN_TITLE_SELECTABLE
Sets the behavior of the column title specified by COLUMN. If SELECTABLE is TRUE, the user can
select the entire column by clicking the title of the column.

Parameter(s)
COLUMN Integer
SELECTABLE Boolean
_SET_COLUMN_VALUE_HANDLER
Defines a user defined value handler for a column. See programming guidelines from SYS600 Visual
SCIL Application Design.

Parameter(s)
COLUMN Integer
Example:
ROOT\ MY_TABLE._SET_COLUMN_VALUE_HANDLER(1, “ROOT\ B“, “ROOT\ A“)

Visual SCIL Objects
VS_TABLE
_SET_COLUMN_VERTICAL_JUSTIFICATION
Sets the vertical justification being used for drawing the text of the COLUMN to JUSTIFICATION. The
JUSTIFICATION is a text string containing one of the following keywords: TOP_JUSTIFY,
BOTTOM_JUSTIFY or CENTER_JUSTIFY.

Parameter(s)
COLUMN Integer
JUSTIFICATION Text
CENTER_JUSTIFY
_SET_COLUMN_WIDTH
Sets the width of the column COLUMN to WIDTH.

Parameter(s)
COLUMN Integer
WIDTH Integer
An integer value.
_SET_ROW_BACKGROUND_COLOR
Sets the background color of the row ROW to COLOR.

Parameter(s)
ROW Integer
COLOR Color
_SET_ROW_EDIT_TYPE_TEXT
This method adds a default text edit type to a row described by parameter ROW.

Parameter(s)
ROW Integer
IS_ONE_LINE Boolean
TEXT Text
_SET_ROW_FONT
Sets the font of the row ROW to FONT.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
FONT Font
_SET_ROW_FOREGROUND_COLOR
Sets the foreground color of the row ROW to COLOR.

Parameter(s)
ROW Integer
COLOR Color
_SET_ROW_GROUP_BACKGROUND_COLOR
Sets the background color being used for the row group specified by arguments LEVEL and

Parameter(s)
LEVEL Integer
COLOR Color
_SET_ROW_GROUP_FONT
Sets the font being used for the row group specified by arguments LEVEL and ORDER_NUMBER to
FONT.

Parameter(s)
LEVEL Integer
FONT Font
_SET_ROW_GROUP_FOREGROUND_COLOR
Sets the foreground color being used for the row group specified by arguments LEVEL and

Visual SCIL Objects
VS_TABLE

Parameter(s)
LEVEL Integer
COLOR Color
_SET_ROW_GROUP_HORIZONTAL_JUSTIFICATION
Sets the horizontal justification being used for the row group specified by arguments LEVEL and
ORDER_NUMBER to JUSTIFICATION. JUSTIFICATION is a text string containing one of the
following keywords: DEFAULT, LEFT_JUSTIFY, RIGHT_JUSTIFY or CENTER_JUSTIFY.

Parameter(s)
LEVEL Integer
JUSTIFICATION Text
CENTER_JUSTIFY
_SET_ROW_GROUP_OBJECT_ID
Sets the identification string of the specified row group. The identification can be any valid text string.
The OBJECT_ID is not used internally in any way, so the SCIL programmer may use it freely.

Parameter(s)
LEVEL Integer
OBJECT_ID Text
_SET_ROW_GROUP_TITLE
Sets the title of the row group specified by arguments LEVEL and ORDER_NUMBER to TITLE. It is
possible to use automatic numbering in the row group. The title can have “%d“ to show the index of
the group and “%l“ to show the level of the group.

Visual SCIL Objects
VS_TABLE

Parameter(s)
LEVEL Integer
TITLE Text
Example:
This example shows how to use automatic numbering of a row group:
._add_row_group(1,2,1)
._set_row_group_title(1,1,“ %l / %d “)
_SET_ROW_HEIGHT
Sets the height of the row ROW to HEIGHT.

Parameter(s)
ROW Integer
HEIGHT Integer
An integer value.
_SET_ROW_HORIZONTAL_JUSTIFICATION
Sets the horizontal justification of the row ROW to JUSTIFICATION. JUSTIFICATION is a text string
containing one of the following keywords: DEFAULT, LEFT_JUSTIFY, RIGHT_JUSTIFY or
CENTER_JUSTIFY.

Parameter(s)
ROW Integer
JUSTIFICATION Text
CENTER_JUSTIFY
_SET_ROW_OBJECT_ID
Sets the identification string of the specified row. The identification can be any valid text string. The
OBJECT_ID is not used internally in any way, so the SCIL programmer may use it freely.

Parameter(s)
ROW Integer
OBJECT_ID Text

Visual SCIL Objects
VS_TABLE
_SET_ROW_READ_ONLY
Sets the specified row ROW to be READ ONLY if the READ_ONLY argument is TRUE, otherwise the
row is editable. By default, all rows are READ ONLY.

Parameter(s)
ROW Integer
READ_ONLY Boolean
_SET_ROW_TEXT_WRAPPED
Sets the specified row to be WRAPPED if the WRAPPED argument is TRUE, otherwise the row is
not wrapped. By default, rows are not wrapped.

Parameter(s)
ROW Integer
WRAPPED Boolean
_SET_ROW_TITLE
Sets the title of the specified row ROW to TITLE. TITLE is a string to be displayed in the row header
if the header is visible.

Parameter(s)
ROW Integer
TITLE Text
_SET_ROW_TITLE_BACKGROUND_COLOR
Sets background color of the title of the specified row ROW to COLOR.

Parameter(s)
ROW Integer
COLOR Color
_SET_ROW_TITLE_FONT
Sets font of the title of the specified row ROW to FONT.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
FONT Font
_SET_ROW_TITLE_FOREGROUND_COLOR
Sets foreground color the title of the specified row ROW to COLOR.

Parameter(s)
ROW Integer
COLOR Color
_SET_ROW_TITLE_HORIZONTAL_JUSTIFICATION
Sets horizontal justification of the title of the specified row ROW to JUSTIFICATION. JUSTIFICATION
is a text string containing one of the following keywords: DEFAULT, LEFT_JUSTIFY,
RIGHT_JUSTIFY or CENTER_JUSTIFY.

Parameter(s)
ROW Integer
JUSTIFICATION Text
CENTER_JUSTIFY
_SET_ROW_TITLE_RESIZABLE
Sets the behavior of the row title specified by ROW. If RESIZABLE is TRUE, the user can resize the
row height with the cursor.

Parameter(s)
ROW Integer
RESIZABLE Boolean
_SET_ROW_TITLE_SELECTABLE
Sets the behavior of the row title specified by ROW. If SELECTABLE is TRUE, the user can select
the entire row by clicking the title of the row.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
SELECTABLE Boolean
_SET_ROW_VALUE_HANDLER
Defines a user defined value handler for the row ROW. See programming guidelines from SYS600
Visual SCIL Application Design.

Parameter(s)
ROW Integer
Example:
ROOT\ MY_TABLE._SET_ROW_VALUE_HANDLER(1, “ROOT\ B“, “ROOT\ A“)
_SET_ROW_VERTICAL_JUSTIFICATION
Sets vertical justification of the row of the specified row ROW to JUSTIFICATION. JUSTIFICATION is
a text string containing one of the following keywords: TOP_JUSTIFY, BOTTOM_JUSTIFY or
CENTER_JUSTIFY.

Visual SCIL Objects
VS_TABLE

Parameter(s)
ROW Integer
JUSTIFICATION Text
CENTER_JUSTIFY
_SORT
This method forces the table to be sorted based on the _SORT_CRITERIA.
Example:
.SET MY_TABLE._SORT_CRITERIA = VECTOR((1,“ASCENDING“),(3,“DESCENDING“))
MY_TABLE._SORT
_UNFREEZE_COLUMNS
This method unfreezes columns previously frozen. If there are no frozen columns, the method does
nothing.

Visual SCIL Objects
452
VS_TEXT
Section 43 VS_TEXT GUID-B7C7B970-1B01-4445-B302-93F1A38C313E v1
43.1 Overview GUID-564C656D-963C-4E43-9308-2DD8E867D6E0 v1
A VS_TEXT object is a text field for editing single or multilined texts. An object can be set to read
only by setting the _MODIFIABLE attribute.
43.1.1 Action Attributes GUID-53049FA8-9377-44EE-9037-9328452F7793 v1
Name Type
"_CHANGE_FILTER" Text vector
"_DELETE_FILTER" Text vector
"_GOT_FOCUS" Text vector
"_INPUT_FILTER" Text vector
"_LOST_FOCUS" Text vector
"_TEXT_DIMENSION_ERROR" Text vector
43.1.2 Action Methods GUID-484E0C91-0AAA-49D0-80BE-396BDDBBE7D2 v1
Name Type
"CHANGE_FILTER" Boolean
"DELETE_FILTER" Boolean
"GOT_FOCUS" No return value
"INPUT_FILTER" Boolean
"LOST_FOCUS" No return value
"TEXT_DIMENSION_ERROR" No return value
43.1.3 Predefined Attributes GUID-108D31F1-DDED-4D94-BC11-DB1593BD5F6A v1
Name Type
"_ACTIVE" Boolean
"_AUTO_INSERT_ENABLED" Boolean

Visual SCIL Objects
VS_TEXT
"_DRAG_DROP_EDIT_ENABLED" Boolean
"_ENABLED" Boolean
"_FIRST_VISIBLE_LINE" Integer
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List
"_IS_ONE_LINE" Boolean
"_LEFT_MARGIN" Integer
"_LINE_COUNT" Integer
"_OBJECT_NAME" Text
"_SELECTED_TEXT_POS_BEHAVIOUR" Text
"_TEXT" Text
"_TEXT_VECTOR" Vector
"_TOP_MARGIN" Integer
"_VISIBLE" Boolean
"_VISIBLE_LINE_COUNT" Integer
43.1.4 Predefined Methods GUID-07069F75-2D20-4AB2-829D-7E6B6ED0CFDF v1
Name Type
"_GET_SELECTED_TEXT" Vector
"_GET_SELECTED_TEXT_POS" List

Visual SCIL Objects
VS_TEXT
"_GET_VISIBLE_TEXT_POS" List
"_SET_SELECTED_TEXT" Boolean
"_SET_SELECTED_TEXT_POS" No return value
43.2 Details GUID-7A01A59E-6845-49D1-B851-BFD34106472A v1
43.2.1 Action Attributes GUID-7736AE88-50DC-45DC-A4C0-D99915CDB346 v1
_CHANGE_FILTER
Setting this attribute specifies the action method CHANGE_FILTER.
_DELETE_FILTER
Setting this attribute specifies the action method DELETE_FILTER.
_GOT_FOCUS
Setting this attribute specifies the action method GOT_FOCUS.
_INPUT_FILTER
Setting this attribute specifies the action method INPUT_FILTER.
_LOST_FOCUS
Setting this attribute specifies the action method LOST_FOCUS.
_TEXT_DIMENSION_ERROR
Setting this attribute specifies the action method TEXT_DIMENSION_ERROR.

Visual SCIL Objects
VS_TEXT
_TOOLTIP_IS_SHOWN
43.2.2 Action Methods GUID-6A771723-E6F4-48F9-9870-D2EDA5C8D1FD v1
CHANGE_FILTER
This action method is executed whenever a change is about to take place in a text field. The result of
the change, if fulfilled, is passed to the method as argument 1. This way the user can check the
result of the change before it has been executed, and either acknowledge it by returning TRUE or
stopping it by returning FALSE. Note that this action method is executed only for text objects, in
which the _IS_ONE_LINE attribute is set to TRUE. Within this action method, no commands that
may cause the input focus to change are allowed. If such commands are needed, they should be
executed outside of this action method using the method QUEUE_FOR_EXECUTION.
DELETE_FILTER
The action method DELETE_FILTER is executed when the object is set programmatically.
GET_TABLE_EDIT_TEXT
executed just before the edit object of a cell is closed (just before the CELL_EDITING_ACCEPTED
GET_TABLE_VIEW_TEXT
This action method is executed whenever a table needs a value for the view object of the current cell.
For example, this method is executed when the view object is drawn into the cell. This function can
be used, for example, to convert edit object value of the cell to the text value of the cell.

Visual SCIL Objects
VS_TEXT
GOT_FOCUS
This program is run whenever an object has received keyboard focus. Within this action method, no
commands that may cause the input focus to change are allowed. If such commands are needed,
they should be executed outside of this action method using the method
QUEUE_FOR_EXECUTION.
INPUT_FILTER
This function provides a possibility to filter and/or reject a text that is inserted into a text field. The
INPUT_FILTER action method gets the text that is going to be inserted into the field as the first
argument to this function. The user can examine the text and return TRUE if the text should be
accepted and FALSE if the text should be rejected. The action method INPUT_FILTER is executed
when setting the object programmatically. Note that the text that is going to be inserted into the field
can contain more than one character, for example if the text is assigned into the field by setting the
attribute _TEXT.
LOST_FOCUS
This program is run whenever an object has lost keyboard focus. This function can be used, for
example, to validate the contents of a text field when the user has left the field. Within this action
method, no commands that may cause the input focus to change are allowed. If such commands are
needed, they should be executed outside of this action method using the method
TEXT_DIMENSION_ERROR
Executed if the user tries to type or paste text, resulting the exceeding of allowed text dimensions.
This action method is also called if the user deletes LINEFEED characters causing the text to exceed
the allowed text dimensions.
TOOLTIP_IS_SHOWN
of a view object to the edit object value.
This action method is executed whenever a table needs a value for a view object. This method is
convert the text value of the cell, to the current value of the view object, which is shown in the view
the cell.

Visual SCIL Objects
VS_TEXT
43.2.3 Predefined Attributes GUID-FA7BE780-179B-46A1-B7D5-DEE8366A0431 v1
_ACTIVE
Specifies whether a text is active or not. This attribute is TRUE if the text view is active or has focus,
otherwise FALSE.

Data type: Boolean
Access: Read-only
_ATTRIBUTE_NAMES
_AUTO_INSERT_ENABLED
Specifies whether the auto insert function is used or not. This attribute is TRUE if auto inserting is
enabled, otherwise FALSE.

Data type: Boolean
Access: Read-only
Specifies whether the auto scroll function is used or not. This attribute is TRUE if auto scrolling is
enabled, otherwise FALSE.

Data type: Boolean
Default value: TRUE
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Visual SCIL Objects
VS_TEXT

Data type: Boolean
Default value: TRUE
Example:
_DRAG_DROP_EDIT_ENABLED
Specifies whether the drag and drop edit is used or not. This attribute is TRUE if drag and drop
editing is enabled, otherwise FALSE.

Data type: Boolean
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FIRST_VISIBLE_LINE
The line number of the first visible line. The text can be scrolled using this attribute.

Data type: Integer
_FOCUSABLE

Visual SCIL Objects
VS_TEXT

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
Specifies whether the Grabbing hand is used or not. This attribute returns TRUE if the Grabbing
hand is active when mouse clicks occur in the text, otherwise FALSE.

Data type: Boolean

Visual SCIL Objects
VS_TEXT
_HAS_BORDER

Data type: Boolean
Default value: TRUE
Example:

Data type: Boolean

Data type: Boolean
_IS_ONE_LINE
Specifies if a text is a one line text or not. A one line text does not allow RETURN to be entered from
the keyboard. This attribute should be set to TRUE for an input field that contains only one line to
prevent the text from scrolling out of view if RETURN is pressed.

Data type: Boolean
Example:
.SET MY_TEXT._IS_ONE_LINE = TRUE
_LEFT_MARGIN
Specifies the left margin for a text. The margin is the amount of space in pixels between the left edge
of the text dialog item and the left edge of the text rectangle (where text is displayed).

Visual SCIL Objects
VS_TEXT

Data type: Integer
_LINE_COUNT
The number of text lines in the object.
Data type: Integer
Access: Read-only
_MODIFIABLE
Specifies whether the text of a text item is modifiable or not. A non-modifiable text item will not allow
text to be entered via the keyboard. However, it will allow the text to be changed programmatically.

Data type: Boolean
Default value: TRUE
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
the object.

Example:
_SCIL_GEOMETRY

Visual SCIL Objects
VS_TEXT
_SELECTABLE
Specifies whether the text string of a text item is selectable or not. An unselectable text object will not
allow selection via the mouse.

Data type: Boolean
Default value: TRUE
_SELECTED_TEXT_POS_BEHAVIOUR
The enum with possible values NCLUDE_LAST_CARRIAGE_RETURN and
EXCLUDE_LAST_CARRIAGE_RETURN which defines the behavior of the
_SET_SELECTED_TEXT_POS method.

INCLUDE_LAST_CARRIAGE_RETURN,
EXCLUDE_LAST_CARRIAGE_RETURN.
Data type: Text
Default value: "INCLUDE_LAST_CARRIAGE_RETURN"
_SOURCE_FILE_NAME
_TEXT
Specifies the text string of a text item. The maximum length of a text line is 255 characters.

Data type: Text
_TEXT_VECTOR
Specifies the multiline text string of the a item.

Data type: Vector
_TOP_MARGIN
Specifies the top margin for a text. The margin is the amount of space in pixels between the top edge
of a text dialog item and the top edge of the text rectangle (where text is displayed).

Visual SCIL Objects
VS_TEXT

Data type: Integer
_TOOLTIP_TEXT
Data type: Text
Example:
_VARIABLE_NAMES

Data type: Boolean

Data type: Boolean
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
_VISIBLE_LINE_COUNT
Specifies the number of lines currently visible in the object.

Visual SCIL Objects
VS_TEXT

Data type: Integer
Access: Read-only
43.2.4 Predefined Methods GUID-CE14B65B-3CD6-4B46-BA9F-2CED2D8935A0 v1
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_SELECTED_TEXT
Returns the text that is currently selected.
Return value data type: Vector
_GET_SELECTED_TEXT_POS
Returns a list containing the positions of a selected text. The function also returns the position of a
LINEFEED character if it is selected.
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_GET_VISIBLE_TEXT_POS
Returns a list containing the first and the last positions of the visible text.
Scrolls the text so that the specified character is at least partly visible. The character is displayed as
close to the left upper corner as possible.

Visual SCIL Objects
VS_TEXT

Parameter(s)
START_LINE Integer
START_CHAR_IN_LINE Integer
An integer value.
Scrolls the text so that the text that is currently selected is also at least partly visible.
_SELECT_TEXT_RANGE
Selects the range of text in a text object or places the cursor in the text. When the start parameter is
1, the starting position for the selection is before the first character. When the start parameter is -1,
the starting position for the selection is after the last character. Length parameter 0 indicates placing
the cursor in the text without selecting any characters. A positive length parameter defines the
number of selected characters to the right from the starting point. A negative length parameter
defines the number of selected characters to the left from the starting point. The length parameter is
automatically truncated to the length of the text. Note that this method is only valid for text objects
where the _IS_ONE_LINE attribute is set to TRUE.

Parameter(s)
START Integer
An integer value.
LENGTH Integer
An integer value.
_SET_SELECTED_TEXT
Modifies the current text selection. If no text is selected, the given text is inserted where the cursor is
positioned. If some text is selected, it will be replaced. If a text vector that exceeds the allowed text
dimension is given as a parameter, the function returns FALSE and the text is not modified.

Parameter(s)
TEXT Vector
_SET_SELECTED_TEXT_POS
Selects the text within the specified bounds. Bounds specify positions between symbols starting from
1. Behavior of this method can be controlled by the attribute
_SELECTED_TEXT_POS_BEHAVIOUR.

Parameter(s)
START_LINE Integer

Visual SCIL Objects
VS_TEXT
An integer value.
END_LINE Integer
END_CHAR_IN_LINE Integer
An integer value.

Visual SCIL Objects
468
VS_TEXT_EDITOR
Section 44 VS_TEXT_EDITOR GUID-7F25D9EB-293F-42A4-B450-9F608E367C61 v1
44.1 Overview GUID-BD1C7D9A-DC93-4788-8E86-B52C97E435AC v1
The VS_TEXT_EDITOR object is a base component for implementing different kinds of text editors.
The object itself contains editing functionalities, such as find/replace, indenting, etc.
44.1.1 Action Attributes GUID-33ABF10E-483B-4601-A975-E35848C641E2 v1
Name Type
"_CHANGE_FILTER" Text vector
"_DELETE_FILTER" Text vector
"_GOT_FOCUS" Text vector
"_INPUT_FILTER" Text vector
"_LOST_FOCUS" Text vector
"_TEXT_DIMENSION_ERROR" Text vector
44.1.2 Action Methods GUID-B10962E6-18BC-4232-B137-2ACFBC60746F v1
Name Type
"CHANGE_FILTER" Boolean
"DELETE_FILTER" Boolean
"GOT_FOCUS" No return value
"INPUT_FILTER" Boolean
"LOST_FOCUS" No return value
"TEXT_DIMENSION_ERROR" No return value
44.1.3 Predefined Attributes GUID-3BB7903D-28CE-472A-95FB-62A2A5F79146 v1
Name Type
"_AUTO_INDENT_ENABLED" Boolean
"_DRAG_DROP_EDIT_ENABLED" Boolean
"_ENABLED" Boolean
"_FIRST_VISIBLE_LINE" Integer
"_FOCUSED" Boolean

Visual SCIL Objects
VS_TEXT_EDITOR
"_FONT" Font
"_GEOMETRY" List
"_INDENT_CHARACTER_COUNT" Integer
"_LEFT_MARGIN" Integer
"_LINE_COUNT" Integer
"_OBJECT_NAME" Text
"_SELECTED_TEXT_POS_BEHAVIOUR" Text
"_TEXT_IS_MODIFIED" Boolean
"_TEXT_VECTOR" Vector
"_TOP_MARGIN" Integer
"_UNDO_ENABLED" Boolean
"_VISIBLE" Boolean
"_VISIBLE_LINE_COUNT" Integer
44.1.4 Predefined Methods GUID-DD2732E8-F149-4457-BE32-0F022788CD26 v1
Name Type
"_COMMENT_LINES" Boolean
"_FIND" List
"_GET_CURRENT_WORD" Text
"_GET_CURRENT_WORD_POS" List
"_GET_SELECTED_TEXT" Vector
"_GET_SELECTED_TEXT_POS" No return value
"_GET_VISIBLE_TEXT_POS" No return value
"_INDENT_LINES" Boolean

Visual SCIL Objects
VS_TEXT_EDITOR
"_REDO" Boolean
"_SELECT_BLOCK" List
"_SET_SELECTED_TEXT" Boolean
"_SET_SELECTED_TEXT_POS" No return value
"_UNCOMMENT_LINES" Boolean
"_UNDO" Boolean
"_UNINDENT_LINES" Boolean
44.2 Details GUID-F2E3917B-EA89-4056-8D2E-C4EF6B27C4FC v1
44.2.1 Action Attributes GUID-A6CFE6F8-B598-4811-9706-C70D144A0360 v1
_CHANGE_FILTER
Setting this attribute specifies the action method CHANGE_FILTER.
_DELETE_FILTER
Setting this attribute specifies the action method DELETE_FILTER.
_GOT_FOCUS
Setting this attribute specifies the action method GOT_FOCUS.
_INPUT_FILTER
Setting this attribute specifies the action method INPUT_FILTER.
_LOST_FOCUS
Setting this attribute specifies the action method LOST_FOCUS.
_TEXT_DIMENSION_ERROR
Setting this attribute specifies the action method TEXT_DIMENSION_ERROR.
_TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_TEXT_EDITOR
44.2.2 Action Methods GUID-38CBD350-5CD8-4DE5-B22A-C405915BB984 v1
CHANGE_FILTER
This action method is executed whenever a change is about to take place in a text field. If the result
of the change is fulfilled, it is passed to the method as argument 1. This way, the user can check the
result of the change before it has been executed, and either acknowledge it by returning TRUE or
stopping it by returning FALSE. Note that this action method is executed only for text objects which
can only have one line (set in dialog editor). Within this action method, no commands that may cause
the input focus to change are allowed. If such commands are needed, they should be executed
outside of this action method using the method QUEUE_FOR_EXECUTION.
DELETE_FILTER
The action method DELETE_FILTER is executed when setting the object programmatically.
GOT_FOCUS
This program is run whenever an object has received keyboard focus. Within this action method, no
commands that may cause the input focus to change are allowed. If such commands are needed,
they should be executed outside of this action method using the method
INPUT_FILTER
This function provides a possibility to filter and/or reject the text that is inserted into a text field. The
INPUT_FILTER action method gets the text that is going to be inserted into the field as the first
argument to this function. The user can examine the text and return TRUE if the text should be
accepted, and FALSE if the text should be rejected. The action method INPUT_FILTER is executed
whenthe object is set programmatically. Note that the text that is going to be inserted into the field
can contain more than one character, for example if the text is assigned into the field by setting the
attribute _TEXT_VECTOR.
LOST_FOCUS
This program is run whenever an object has lost keyboard focus. This function can be used, for
example, to validate the contents of a text field when the user has left the field. Within this action
method, no commands that may cause the input focus to change are allowed. If such commands are
needed, they should be executed outside of this action method using the method
TEXT_DIMENSION_ERROR
Executed if the user tries to type or paste text, resulting in exceeding the allowed text dimensions.
This action method is also called if the user deletes LINEFEED characters causing the text to exceed
the allowed text dimensions.
TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_TEXT_EDITOR
44.2.3 Predefined Attributes GUID-E8BF876A-7F55-46DC-89C5-9822A868B463 v1
_ATTRIBUTE_NAMES
_AUTO_INDENT_ENABLED
Specifies whether automatic indentation is enabled or not.

Data type: Boolean
Default value: TRUE
Specifies whether auto scroll is used or not. This attribute is TRUE if autoscrolling is enabled,
otherwise FALSE.

Data type: Boolean
Default value: TRUE
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Example:

Visual SCIL Objects
VS_TEXT_EDITOR
_DRAG_DROP_EDIT_ENABLED
Specifies whether the drag and drop edit feature is used or not. This attribute is TRUE if drag and
drop editing is enabled, otherwise FALSE.

Data type: Boolean
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FIRST_VISIBLE_LINE
Specifies the line number of the first visible line. The text can be scrolled using this attribute.

Data type: Integer
_FOCUSABLE

Data type: Boolean
Example:
_FOCUSED

Visual SCIL Objects
VS_TEXT_EDITOR

Data type: Boolean
Default value: TRUE
Access: Environment dependent
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
Specifies whether the Grabbing hand is used or not. This attribute returns TRUE if the Grabbing
hand is active when mouse clicks occur in the text, otherwise FALSE.

Data type: Boolean
_HAS_BORDER

Data type: Boolean
Example:

Visual SCIL Objects
VS_TEXT_EDITOR

Data type: Boolean

Data type: Boolean
_INDENT_CHARACTER_COUNT
Specifies the number of characters used when indenting text either by using the TAB key or the
_INDENT_LINES method.

Data type: Integer
Default value: 3
_LEFT_MARGIN
Specifies the left margin for the text. The margin is the amount of space in pixels between the left
edge of the text dialog item and the left edge of the text rectangle (where text is displayed).

Data type: Integer
_LINE_COUNT
Specifies the number of text lines in the object.

Data type: Integer
Access: Read-only
_MODIFIABLE
Specifies whether the text of a text item is modifiable or not. A non-modifiable text item will not allow
text to be entered via the keyboard. However, it will allow the text to be changed programmatically.

Visual SCIL Objects
VS_TEXT_EDITOR

Data type: Boolean
Default value: TRUE
_OBJECT_CLASS
_OBJECT_NAME
_POP_UP_MENU
the object.

Example:
_SCIL_GEOMETRY
_SELECTABLE
Specifies whether the text string of a text item is selectable or not. An unselectable text object will not
allow selection via the mouse.

Data type: Boolean
Default value: TRUE
_SELECTED_TEXT_POS_BEHAVIOUR
The enum with possible values INCLUDE_LAST_CARRIAGE_RETURN and
EXCLUDE_LAST_CARRIAGE_RETURN which defines the behavior of the
_SET_SELECTED_TEXT_POS method.

Visual SCIL Objects
VS_TEXT_EDITOR

INCLUDE_LAST_CARRIAGE_RETURN,
EXCLUDE_LAST_CARRIAGE_RETURN.
Data type: Text
Default value: "INCLUDE_LAST_CARRIAGE_RETURN"
_SOURCE_FILE_NAME
_TEXT_IS_MODIFIED
Indicates whether a text has been modified since the last time this flag was cleared (the attribute set
to FALSE). This flag should be cleared, for example, when saving the text. If _UNDO_ENABLED is
TRUE and the user clears the flag, the undo action list is cleared.

Data type: Boolean
_TEXT_VECTOR
Specifies the multiline text string of a text item.

Data type: Vector
_TOP_MARGIN
Specifies the top margin for the text. The margin is the amount of space in pixels between the top
edge of a text dialog item and the top edge of the text rectangle (where text is displayed).

Data type: Integer
_TOOLTIP_TEXT
Data type: Text
Example:

Visual SCIL Objects
VS_TEXT_EDITOR
_UNDO_ENABLED
Specifies whether the undo functionality is enabled or not. If this attribute is TRUE, editing actions
can be undone and redone by running the _UNDO and _REDO methods.

Data type: Boolean
_VARIABLE_NAMES

Data type: Boolean
Default value: fALSE

Data type: Boolean
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
_VISIBLE_LINE_COUNT
Specifies the number of lines currently visible in the object.

Visual SCIL Objects
VS_TEXT_EDITOR

Data type: Integer
Access: Read-only
44.2.4 Predefined Methods GUID-1BFC3260-A278-48CE-BB13-E1E86C15C698 v1
_COMMENT_LINES
Comments the specified range of lines. The comment sign is places at the beginning of the lines.

Parameter(s)
START_LINE Integer
END_LINE Integer
_FIND
The parameter CASE_SENSITIVE should be TRUE or FALSE depending on whther the user wants
the find function to be case sensitive or not. The parameter DIRECTION should be UP or DOWN
depending on in which direction the user wants to excecute the find function. If the user wants to
search to the end of the text without having to know the position of text end, the user can give the
maximum amount (lenght of a SCIL vector) of lines as the parameter END_LIN, and the maximum
amount (1023) of text in one line as the parameter END_CHAR_IN_LINE .

Parameter(s)
WHAT Text
START_LINE Integer
An integer value.
END_LINE Integer
An integer value.
CASE_SENSITIVE Boolean
DIRECTION Text.
UP or DOWN
_FLAG_FOR_EXECUTION
_GET_CURRENT_WORD
This method returns the word on which the cursor currently is positioned. If the user has selected
some text, the method returns currently selected text.

Visual SCIL Objects
VS_TEXT_EDITOR
_GET_CURRENT_WORD_POS
This method returns the position of the word on which the cursor currently is positioned. If the user
has selected some text, the method returns currently selected text position.
_GET_HELP
_GET_SELECTED_TEXT
Returns the text that is currently selected.
Return value data type: Vector
_GET_SELECTED_TEXT_POS
Returns a list containing the positions of the selected text. The function also returns the position of
LINEFEED character if it is selected.
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_GET_VISIBLE_TEXT_POS
Returns a list containing the first and the last positions of the visible text.
_INDENT_LINES
Indents the specified range of lines.

Parameter(s)
START_LINE Integer
END_LINE Integer
_REDO
Redoes a previously undone editing action.

Visual SCIL Objects
VS_TEXT_EDITOR
Scrolls the text so that the specified character is at least partly visible. The character is displayed as
close to the upper left corner as possible.

Parameter(s)
START_LINE Integer
An integer value.
Scrolls the text so that the text that is currently selected is at least partly visible.
_SELECT_BLOCK
If the user wants to search to the end of a text without having to know the position of the text end, the
user can give the maximum amount (10000) of lines as the "endline" parameter, and the maximum
amount (255) of text in one line as the "char" parameter for endline.

Parameter(s)
START_LINE Integer
An integer value.
END_LINE Integer
An integer value.
_SET_SELECTED_TEXT
Modifies the current text selection. If no text is selected, the text given is inserted where the cursor is
positioned. If some text is selected, it is replaced. If a text vector that exceeds the allowed text
dimension is given as a parameter, the function returns FALSE and the text is not modified.

Parameter(s)
TEXT Vector
_SET_SELECTED_TEXT_POS
Selects the text within the specified bounds. Bounds specify the positions between symbols starting
from 1. The behavior of this method can be controlled by the attribute
_SELECTED_TEXT_POS_BEHAVIOUR.

Visual SCIL Objects
VS_TEXT_EDITOR

Parameter(s)
START_LINE Integer
An integer value.
END_LINE Integer
An integer value.
_UNCOMMENT_LINES
Uncomments the specified range of lines. One comment sign at the beginning of each row is
removed.

Parameter(s)
START_LINE Integer
END_LINE Integer
_UNDO
Undoes the previous editing action. The undo operation revokes the last editing operation. The
maximum number of actions that can be undone is 50. The _UNDO method returns FALSE if called
after max count is reached.
_UNINDENT_LINES
Unindents the specified range of lines.

Parameter(s)
START_LINE Integer
END_LINE Integer

Visual SCIL Objects
484
VS_TEXT_SPINNER
Section 45 VS_TEXT_SPINNER GUID-4E68AF73-536B-4F58-901B-8E9DDA1788A4 v1
45.1 Overview GUID-F0E97D3F-855D-447F-9E9F-1B578611C595 v1
The VS_TEXT_SPINNER object is an object that allows the selection of a text value. The
appearance of the object is dependent on the platform. Text can be added to the object by using the
_APPEND_TEXT method. The _VALUE attribute contains the ordinal number of the currently
selected text. The NOTIFY method for this object will be called whenever the user interactively
changes the value of the object.
45.1.1 Action Attributes GUID-702F52B4-853A-410C-B916-C12C6ECB5E92 v1
Name Type
45.1.2 Action Methods GUID-0A22C75E-8690-44F9-937B-B62503A6FE7F v1
Name Type
45.1.3 Predefined Attributes GUID-929BBBC9-257D-4D8F-9648-EF8913F82B21 v1
Name Type
"_ENABLED" Boolean
"_FOCUSED" Boolean
"_FONT" Font
"_GEOMETRY" List

Visual SCIL Objects
VS_TEXT_SPINNER
"_OBJECT_NAME" Text
"_TEXT" Text
"_TEXT_COUNT" Integer
"_VISIBLE" Boolean
45.1.4 Predefined Methods GUID-5D90AE66-DFB1-41A5-8DBA-16A5B1081747 v1
Name Type
"_DELETE_TEXT" No return value
"_GET_TEXT_AT" Text
"_GET_TEXT_INDEX" Integer
"_SELECT_TEXT" No return value
"_SELECT_TEXT_AT" No return value
"_SET_TEXT_AT" No return value
"_SORT_LIST" No return value
45.2 Details GUID-9CA5FA43-D1F2-4B1D-A83D-D265CF986152 v1
45.2.1 Action Attributes GUID-CC9A1E9B-D5C0-4BB3-AF0D-CD1FBC229347 v1
_NOTIFY

Visual SCIL Objects
VS_TEXT_SPINNER
Example:
_TOOLTIP_IS_SHOWN
45.2.2 Action Methods GUID-9B44F7F5-8FB6-42E1-914D-62C7C275C304 v1
GET_TABLE_EDIT_TEXT
action method). This function can be used, for example, to convert internal edit object value to a text
GET_TABLE_VIEW_TEXT
NOTIFY
TOOLTIP_IS_SHOWN

Visual SCIL Objects
VS_TEXT_SPINNER
the cell.
45.2.3 Predefined Attributes GUID-988E3860-8420-464A-896B-07CC39DF944B v1
_ATTRIBUTE_NAMES
_AUTO_SORT_ENABLED
Specifies whether the auto sort function is used or not. The texts in text spinner are sorted
automatically when set to TRUE.

Data type: Boolean
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:

Visual SCIL Objects
VS_TEXT_SPINNER
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:
_FONT
Example:
_FOREGROUND_COLOR
Example:

Visual SCIL Objects
VS_TEXT_SPINNER
_GEOMETRY
Example:
_MODIFIABLE
Specifies whether the value of a text spinner is modifiable or not. A change of appearance is also
often combined with this attribute.

Data type: Boolean
Default value: TRUE
_OBJECT_CLASS
_OBJECT_NAME
_SCIL_GEOMETRY
_SELECTED_INDEX
Specifies the index of a selected text string in the text spinner.

Data type: Integer
Default value: 0
_SOURCE_FILE_NAME
_TEXT
Specifies the current text in text spinner.

Data type: Text
Access: Read-only
_TEXT_COUNT
Specifies the number of texts in text spinner.

Visual SCIL Objects
VS_TEXT_SPINNER

Data type: Integer
Default value: 0
Access: Read-only
_TOOLTIP_TEXT
Data type: Text
Example:
_VARIABLE_NAMES
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
_WRAP_ENABLED
Specifies whether the values displayed in the numeric spinner can increase or decrease straight from
one end point of the spinner to another end point, for example from the maximum value to the
minimum value. Maximum and minimum values of the numeric spinner are specifiied by using
attributes _MIN_VALUE and _MAX_VALUE.

Data type: Boolean
45.2.4 Predefined Methods GUID-F690896A-D9F8-409E-A1A9-431EB4238253 v1
_APPEND_TEXT
Appends a text string to the text spinner. If the attribute _AUTO_SORT_ENABLED is set to FALSE
then the text is appended to the end of the list. Otherwise, the text spinner is sorted automatically.

Visual SCIL Objects
VS_TEXT_SPINNER

Parameter(s)
TEXT Text
_DELETE_TEXT
Deletes the specified text string if it exists in the text spinner.

Parameter(s)
TEXT Text
_DELETE_TEXT_AT
Deletes the text string at a specific index.

Parameter(s)
INDEX Integer
An integer value.
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_GET_TEXT_AT
Returns the text string at a specified index.

Parameter(s)
INDEX Integer
An integer value.
_GET_TEXT_INDEX
Returns the index at a specified text string.

Visual SCIL Objects
VS_TEXT_SPINNER

Parameter(s)
TEXT Text
_SELECT_TEXT
Selects the specified text string in the text spinner.

Parameter(s)
TEXT Text
_SELECT_TEXT_AT
Selects the text string at the specified index in the text spinner.

Parameter(s)
INDEX Integer
An integer value.
_SET_TEXT_AT
Sets the text string at the specified index in the text spinner.

Parameter(s)
TEXT Text
INDEX Integer
An integer value.
_SORT_LIST
Sorts the texts in the text spinner. Note that when appending or deleting text into list, the list is not
automatically sorted. Use attribute _AUTO_SORT_ENABLED instead.

Visual SCIL Objects
494
VS_TOGGLE_MENU_ITEM
Section 46 VS_TOGGLE_MENU_ITEM GUID-A91DE2DD-5098-4190-9ACC-8F10947F4861 v1
46.1 Overview GUID-870275DE-A75B-4120-865E-5AE3EA48DD1C v1
A VS_TOGGLE_MENU_ITEM is a special kind of menu item that has a state. It has an _ON attribute
that can be TRUE or FALSE. The indication of the state can vary according to the look-and-feel on
different platforms. The VS_TOGGLE_MENU_ITEM also has an attribute _EXCLUSIVE, which
indicates that only one toggle menu item in a group can be in the _ON state at a time. The group of
VS_TOGGLE_MENU_ITEMs must be separated from other menu items using the
VS_SEPARATOR_MENU_ITEM.
46.1.1 Action Attributes GUID-80DBE120-73C1-4B22-8283-F459EECDAB32 v1
Name Type
46.1.2 Action Methods GUID-B24C2D9C-C2E2-416E-81D7-CA4073845044 v1
Name Type
46.1.3 Predefined Attributes GUID-5F59ACFC-4CD9-46B9-83AF-A17FB21F67BA v1
Name Type
"_ENABLED" Boolean
"_EXCLUSIVE" Boolean
"_FONT" Font
"_MNEMONIC" Text
"_OBJECT_NAME" Text
"_ON" Boolean
"_TITLE" Text
46.1.4 Predefined Methods GUID-EE18FEA5-1A7B-440C-8A2E-C747A67C86B5 v1
Name Type

Visual SCIL Objects
VS_TOGGLE_MENU_ITEM
46.2 Details GUID-81392787-F60A-48F8-B64F-30EF06B2AEA6 v1
46.2.1 Action Attributes GUID-2F22FC58-205D-4596-BD57-A74B5CB5FA7C v1
_NOTIFY
46.2.2 Action Methods GUID-95E79F41-F1A4-4CE0-AB78-599CC1D7950B v1
NOTIFY
Specifies the NOTIFY action method for the menu item. This is executed when the menu item is
selected.
46.2.3 Predefined Attributes GUID-6C8A0E41-2C9D-4343-BA27-785F5CBC54E8 v1
_ATTRIBUTE_NAMES
_CHILD_OBJECTS
_ENABLED
Specifies whether a menu item is enabled or not. Changing this attribute also affects the appearance
of the menu item.

Data type: Boolean
Default value: TRUE
_EXCLUSIVE
If this attribute is TRUE, it indicates that the toggle menu item is part of a group of menu items, of
which only one should be checked at a time. The _ON attribute, which is automatically set by the
system, specifies whether the menu item is checked or not. The group of menu items must be
separated within the menu with separator menu items.

Data type: Boolean
_FILE_REVISION

Visual SCIL Objects
VS_TOGGLE_MENU_ITEM
_FONT
_FOREGROUND_COLOR
_MNEMONIC
mnemonic character in menu item.

Data type: Text
_OBJECT_CLASS
_OBJECT_NAME
_ON
The _ON attribute specifies whether a toggle menu item is checked or not.

Data type: Boolean
_SOURCE_FILE_NAME
_TITLE

Data type: Text
_VARIABLE_NAMES

Visual SCIL Objects
VS_TOGGLE_MENU_ITEM
46.2.4 Predefined Methods GUID-C6931E3D-C8B5-471B-BC85-295E7081D9EB v1
_FLAG_FOR_EXECUTION
_GET_HELP

Visual SCIL Objects
VS_TREE
Section 47 VS_TREE GUID-6AF0FC6B-5B51-4040-B7C4-2DF43BCAAC17 v1
47.1 Overview GUID-180DCD1C-2911-42F2-A96C-EC68685AA7CE v1
A VS_TREE is an object used to display hierarchical data. The behavior of the tree is defined
through its different action methods. The most important action method is HANDLE_EXPAND_NODE
that is run whenever the user tries to open a specific node. All nodes or leafs (except the root node)
that is to be displayed must be added within this method. When the user tries to open/close a node
or selects a leaf, the row number is passed as argument. The row number indexing begins from 1.
47.1.1 Action Attributes GUID-5AB40579-D1DD-474E-A6C4-D5E8D68315EB v1
Name Type
"_HANDLE_COLLAPSE_NODE" Text vector
"_HANDLE_EXPAND_NODE" Text vector
"_LEAF_SELECTED" Text vector
"_NODE_SELECTED" Text vector
"_NONE_SELECTED" Text vector
47.1.2 Action Methods GUID-A9FEEDFD-DFCD-4530-A2F3-A51733B6CE6E v1
Name Type
"HANDLE_COLLAPSE_NODE" Boolean
"HANDLE_EXPAND_NODE" Boolean
"LEAF_SELECTED" No return value
"NODE_SELECTED" No return value
"NONE_SELECTED" No return value
47.1.3 Predefined Attributes GUID-C239368C-C461-4AC8-AD3C-6A8E8A214CB9 v1
Name Type
"_DEFAULT_CLOSED_IMAGE" Image reference
"_DEFAULT_LEAF_IMAGE" Image reference
"_DEFAULT_OPEN_IMAGE" Image reference
"_ENABLED" Boolean
"_FOCUSED" Boolean

Visual SCIL Objects
VS_TREE
"_FONT" Font
"_GEOMETRY" List
"_OBJECT_NAME" Text
"_OPEN_ICON_ON_SELECT" Boolean
"_VISIBLE" Boolean
47.1.4 Predefined Methods GUID-D8FD9ECC-6ED0-41C9-B1EF-380B47B06EC4 v1
Name Type
"_ADD_LEAF" No return value
"_ADD_NODE" No return value
"_ADD_ROOT_NODE" No return value
"_COLLAPSE_NODE" No return value
"_EXPAND_NODE" No return value
"_GET_ROW_ID" Text
"_GET_ROW_TEXT" Text
"_REMOVE_ROW" No return value
"_SCROLL_ROW_INTO_VIEW" No return value
"_SET_ROW_ID" No return value
"_SET_ROW_IMAGE" No return value
"_SET_ROW_TEXT" No return value

Visual SCIL Objects
VS_TREE
47.2 Details GUID-44D17D60-F5E5-4E73-823F-71B4D0362FF4 v1
47.2.1 Action Attributes GUID-2D25070A-A0CE-43A4-8C1B-23931A473B2B v1
_HANDLE_COLLAPSE_NODE
Setting this attribute specifies the action method HANDLE_COLLAPSE_NODE.
Example:
.SET ROOT\ MY_TREE._HANDLE_COLLAPSE_NODE = (“ROOT.CLOSENODE(ARGUMENT(1))“,

“...
(“ROOT.CLOSENODE(ARGUMENT(1))“,“...
_HANDLE_EXPAND_NODE
Setting this attribute specifies the action method HANDLE_EXPAND_NODE.
Example:
.SET ROOT\ MY_TREE._HANDLE_EXPAND_NODE = (“ROOT.OPENNODE(ARGUMENT(1))“,

“...
_LEAF_SELECTED
Setting this attribute specifies the action method LEAF_SELECTED.
_NODE_SELECTED
Setting this attribute specifies the action method NODE_SELECTED.
_NONE_SELECTED
Setting this attribute specifies the action method NONE_SELECTED.
_TOOLTIP_IS_SHOWN
47.2.2 Action Methods GUID-177E8FA2-45F2-420F-887F-B6EEB5FBD447 v1
HANDLE_COLLAPSE_NODE
This action method is run when the user collapses an opened node by double-clicking it. This method
gets one input parameter, which is the row number of the node that is being collapsed. If the node
can be collapsed, this method should return TRUE, otherwise FALSE.

Visual SCIL Objects
VS_TREE
HANDLE_EXPAND_NODE
This action method is run when the user expands a closed node by double-clicking it. This method
gets one input parameter, which is the row number of the node that is being expanded. Within this
method, the user should add any nodes or leafs that need to be displayed when the node is
expanded. If the node can be expanded, this method should return TRUE otherwise FALSE.
LEAF_SELECTED
This action method is run when a leaf is selected. The method gets one input parameter, which is the
row number of the leaf that has been selected.
NODE_SELECTED
This action method is run when a node is selected. The method gets one input parameter, which is
the row number of the node that has been selected.
NONE_SELECTED
This action method is run when all nodes and leafs in the tree are unselected.
TOOLTIP_IS_SHOWN
47.2.3 Predefined Attributes GUID-0A107663-824B-4891-8B82-59810D869CD8 v1
_ATTRIBUTE_NAMES
_BACKGROUND_COLOR
Example:
_CHILD_OBJECTS
_CLICK_FOCUSABLE

Visual SCIL Objects
VS_TREE

Data type: Boolean
Default value: TRUE
Example:
_DEFAULT_CLOSED_IMAGE
Specifies the default image to be used to visualise a closed node. If a default image is not set, the
system provides a standard image. The most frequently used image for closed node situation is
preferred to use as a default image.

Access: Write-only
Example:
.LOAD ROOT\ CLOSEDIMAGE = VS_IMAGE(“...
.SET ROOT\ MY_TREE._DEFAULT_CLOSED_IMAGE = “ROOT\ CLOSEDIMAGE“
_DEFAULT_LEAF_IMAGE
Specifies the default image to be used to visualise a leaf. If a default image is not set, the system
provides a standard image. The most frequently used image for leaf is preferred to use as a default
image.

Access: Write-only
_DEFAULT_OPEN_IMAGE
Specifies the default image to be used to visualise an open node. If a default image is not set, the
system provides a standard image. The most frequently used image for open node situation is
preferred to use as a default image.

Access: Write-only

Visual SCIL Objects
VS_TREE
_ENABLED

Data type: Boolean
Default value: TRUE
Example:
_FILE_REVISION
_FIRST_VISIBLE_ROW
Contains the index of the uppermost visible row.

Data type: Integer
Default value: 1
Access: Read-only
_FOCUSABLE

Data type: Boolean
Default value: TRUE
Example:
_FOCUSED

Data type: Boolean
Access: Read-only
Example:

Visual SCIL Objects
VS_TREE
_FONT
Example:
_FOREGROUND_COLOR
Example:
_GEOMETRY
Example:
Specifies whether clicking and dragging the mouse in a view invokes the Grabbing hand or simply
view as if the user has grabbed it, so that the scrolling of the view and the movement of the mouse
are synchronous.

Data type: Boolean
_HAS_BORDER

Data type: Boolean
Default value: TRUE
Example:

Visual SCIL Objects
VS_TREE

Data type: Boolean
Specifies whether an object allows keyboard selection through keyboard focus, FALSE otherwise.
This means, for example, that when a list has focus and a key is pressed, the selected cell of the list
changes to the first one that starts with the character pressed.

Data type: Boolean
Default value: TRUE
Specifies if a keyboard traversal is used in list elements or not. If the value is TRUE, the object
cell with keyboard arrow keys. If the value is FALSE, the object will only handle the mouse events. In
this case, the user can make selections or change the focused cell only with mouse.

Data type: Boolean
Default value: TRUE
_OBJECT_CLASS
_OBJECT_NAME
_OPEN_ICON_ON_SELECT
Specifies whether a tree should change icon when a node is opened.

Data type: Boolean
_POP_UP_MENU
the object.

Visual SCIL Objects
VS_TREE

Example:
_ROW_COUNT
Read only attribute that contains the number of currently visible tree items in the tree structure (the
number of rows in the tree).

Data type: Integer
Access: Read-only
_SCIL_GEOMETRY
_SELECTED_ROW
Specifies the row number of the row in the tree that is currently selected.

Data type: Integer
_SOURCE_FILE_NAME
_TOOLTIP_TEXT
Data type: Text
Example:
Specifies whether the content of a list wraps around or not.

Visual SCIL Objects
VS_TREE

Data type: Boolean
Default value: TRUE
_VARIABLE_NAMES

Data type: Boolean
Default value: TRUE
_VISIBLE

Data type: Boolean
Default value: TRUE
Example:
47.2.4 Predefined Methods GUID-E4236F33-FE1A-4F0D-A9B9-B5B44DE5476D v1
_ADD_LEAF
Adds a leaf to the tree. A leaf cannot contain any sub-levels of nodes or leafs. The first parameter
specifies the row number of the parent node, and the second parameter specifies the index where to
insert the new leaf within the parent node.

Parameter(s)
PARENT_ROW Integer
An integer value.
POSITION Integer
An integer value.
_ADD_NODE
Adds a node to the tree. A node can contain more nodes or leafs. The first parameter specifies the
row number of the parent node, and the second parameter specifies the index where to insert the
new node within the parent node.

Visual SCIL Objects
VS_TREE

Parameter(s)
PARENT_ROW Integer
An integer value.
POSITION Integer
An integer value.
_ADD_ROOT_NODE
Adds a root node to the tree. Note that every tree object must contain a root node.
_COLLAPSE_NODE
Collapses the specified node.

Parameter(s)
ROW Integer
An integer value.
_EXPAND_NODE
Expands the specified node.

Parameter(s)
ROW Integer
An integer value.
_FLAG_FOR_EXECUTION
_GET_HELP
_GET_ROW_ID
Returns the identification string associated with the specified row in the tree.

Parameter(s)
ROW Integer
An integer value.
_GET_ROW_TEXT
Returns the text associated with the specified row in the tree.

Visual SCIL Objects
VS_TREE

Parameter(s)
ROW Integer
An integer value.
_GET_STRING_WIDTH

Parameter(s)
STRING Text
_REMOVE_ROW
Removes the specified row.

Parameter(s)
ROW Integer
An integer value.
_SCROLL_ROW_INTO_VIEW
Scrolls the specified row so that it becomes at least partly visible.

Parameter(s)
ROW Integer
Scrolls the list so that the selection is displayed in the view.
_SET_ROW_ID
Sets the identification string of a specified row. Identification can be any valid text string. The ID is not
used internally in any way, so the SCIL programmer may use it freely.

Parameter(s)
ROW Integer
An integer value.
ID Text

Visual SCIL Objects
VS_TREE
_SET_ROW_IMAGE
Sets the image associated with a specified row. If no image is specified, a default image is used.

Parameter(s)
ROW Integer
An integer value.
_SET_ROW_TEXT
Sets the text associated with the specified row.

Parameter(s)
ROW Integer
An integer value.
TEXT Text

Visual SCIL Objects
512
1MRK 511 548-UEN Rev. A Index
Index
_ Predefined methods.................................. 17, 21

_ACCEPT........................................................ 52 R
_ALIGNMENT..................................................36 ROW................................................................36
_ATTRIBUTE_NAMES........................ 17, 28, 36
_BACKGROUND_COLOR.................. 18, 28, 36 T
_BOTTOM_SHADOW_COLOR.................... 224 TEXT............................................................... 36
_CHILD_OBJECTS............................. 18, 28, 36 TOOLTIP_IS_SHOWN... 27, 35, 45, 53, 66, 121,
_CLICK_FOCUSABLE.................................... 37 134, 142, 156, 175, 220, 224, 230, 278, 285,
_ENABLED................................................28, 37 313, 341, 363, 408, 457, 472, 487, 502
_FILE_REVISION................................18, 28, 37 U
_FLAG_FOR_EXECUTION.................21, 31, 42
_FOCUSABLE.................................................37 UPDATE_TABLE_EDIT_TEXT............27, 36, 45
_FOCUSED..................................................... 37 UPDATE_TABLE_VIEW_TEXT...........27, 36, 46
_FONT.................................................19, 28, 38 V
_FOREGROUND_COLOR..........19, 28, 38, 224 VS_BOX.......................................................... 25
_GEOMETRY...................................... 19, 29, 38 VS_BUTTON................................................... 33
_GET_HELP........................................22, 31, 42 VS_CHECK_BOX............................................43
_GET_STRING_WIDTH............................31, 42 VS_IMAGE...................................................... 33
_GET_TABLE_EDIT_TEXT...........25, 26, 34, 44
_GET_TABLE_VIEW_TEXT..........25, 26, 34, 44
_HAS_BORDER........................................29, 38
_HAS_IMAGE_MASK............................... 29, 39
_IMAGE..................................................... 29, 39
_LEADER_DIALOG_ITEM..... 93, 108, 194, 210,
250, 301, 352
_LINE_STYLE............................................... 225
_MAX_HEIGHT............................................... 19
_MAX_WIDTH................................................. 20
_MIN_HEIGHT................................................ 20
_MIN_WIDTH.................................................. 20
_MNEMONIC...................................................39
_NOTIFY................................................... 34, 44
_OBJECT_CLASS...............................20, 30, 40
_OBJECT_NAME................................ 20, 30, 40
_POP_UP_MENU........................................... 40
_QUEUE_FOR_EXECUTION............. 22, 31, 42
_SCIL_GEOMETRY............................ 21, 30, 40
_SELECT.........................................................52
_SET_MAX_SIZE............................................23
_SET_MIN_SIZE............................................. 23
_SOURCE_FILE_NAME..................... 21, 30, 40
_TITLE.......................................................30, 40
_TITLE_VECTOR ...........................................41
_TOOLTIP_IS_SHOWN .. 25, 26, 35, 44, 52, 65,
77, 120, 134, 141, 155, 175, 220, 224, 229, 278
, 284, 312, 340, 362, 407, 456, 471, 487, 501
_TOOLTIP_TEXT..... 30, 41, 48, 58, 71, 83, 124,
136, 146, 162, 182, 221, 225, 237, 281, 289,
316, 345, 368, 379, 395, 418, 464, 478, 491
_TOP_SHADOW_COLOR............................ 225
_UPDATE_TABLE_EDIT_TEXT....25, 26, 35, 45
_UPDATE_TABLE_VIEW_TEXT...25, 26, 35, 45
_VARIABLE_NAMES.......................... 21, 30, 41
_VISIBLE................................................... 30, 41
C
COLUMN......................................................... 36
G
GET_TABLE_EDIT_TEXT...................27, 35, 45
GET_TABLE_VIEW_TEXT..................27, 35, 45
N
NOTIFY............................................... 33, 35, 45
P
Predefined attributes....................................... 17

Visual SCIL Objects
514
515
Hitachi Energy Finland Oy
Grid Automation
PL 688
65101 Vaasa, Finland
https://hitachienergy.com/microscadax
Scan this QR code to visit our website
1MRK 511 548-UEN
© 2021 Hitachi Energy.

All rights reserved.

SYS600 - Visual SCIL Objects

Uploaded by

Copyright:

Available Formats

You might also like

SYS600 - Visual SCIL Objects

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

SYS600 - Visual SCIL Objects

Uploaded by

Copyright:

Available Formats

MicroSCADA X SYS600 10.

© 2021 Hitachi Energy. All rights reserved.

Section 3 General properties.......................................................................................17

MicroSCADA X SYS600 10.3 1

6.1.1 Action Attributes................................................................................................................ 43

2 MicroSCADA X SYS600 10.3

Section 11 VS_FILE_CHOOSER.................................................................................. 103

Section 12 VS_GRAPH................................................................................................. 119

Section 13 VS_GRAPH_LEGEND................................................................................ 133

MicroSCADA X SYS600 10.3 3

Section 15 VS_HEADER_ITEM.................................................................................... 149

Section 17 VS_IMAGE.................................................................................................. 167

4 MicroSCADA X SYS600 10.3

18.2.3 Predefined Attributes.......................................................................................................176

Section 20 VS_INPUT_DIALOG................................................................................... 203

Section 21 VS_LABEL.................................................................................................. 219

MicroSCADA X SYS600 10.3 5

22.2.2 Action Methods................................................................................................................224

Section 23 VS_LIST...................................................................................................... 227

Section 25 VS_MENU................................................................................................... 261

6 MicroSCADA X SYS600 10.3

26.2.1 Action Attributes.............................................................................................................. 268

Section 28 VS_NOTEBOOK......................................................................................... 277

Section 29 VS_NOTEBOOK_PAGE............................................................................. 283

Section 30 VS_NOTICE_DIALOG................................................................................ 291

MicroSCADA X SYS600 10.3 7

30.2 Details............................................................................................................................... 293

Section 31 VS_NUMERIC_SPINNER........................................................................... 311

Section 32 VS_OPTION_BUTTON............................................................................... 319

Section 34 VS_PICTURE_CONTAINER....................................................................... 339

8 MicroSCADA X SYS600 10.3

34.1.4 Predefined Methods........................................................................................................ 340

Section 37 VS_SCROLL_BAR..................................................................................... 375

MicroSCADA X SYS600 10.3 9

38.2 Details............................................................................................................................... 383

Section 40 VS_SPLIT_BAR.......................................................................................... 393

Section 41 VS_SUB_MENU_ITEM............................................................................... 397

Section 42 VS_TABLE.................................................................................................. 401

10 MicroSCADA X SYS600 10.3

Section 44 VS_TEXT_EDITOR..................................................................................... 469

MicroSCADA X SYS600 10.3 11

46.2.4 Predefined Methods........................................................................................................ 498

Section 47 VS_TREE.................................................................................................... 499

12 MicroSCADA X SYS600 10.3

Section 1 Copyrights GUID-03127CB5-2F5A-4099-A5DC-20E63835472E v3

© 2021 Hitachi Energy. All rights reserved.

Third Party Copyright Notices

This product includes software developed by vbAccelerator (/index.html).

MicroSCADA X SYS600 10.3 13

Section 2 Introduction GUID-6F3C0EE1-952C-4780-8BAB-D6F28C638523 v1

2.1 Use of symbols GUID-C2600B91-8566-4D3B-932E-E655846A2FE4 v1

Caution icon indicates important information or a warning related to the concept

Information icon alerts the reader to relevant factors and conditions.

2.2 Intended audience GUID-B7F116C5-66D5-4592-B16D-854450B740C9 v1

2.3 Related documents GUID-37388E79-56FF-41BF-8788-E99E46B90970 v3

Name of the Manual Document ID

2.4 Document conventions GUID-7C6EA139-E805-4AC1-9F4E-D4C3812C9916 v1

The following conventions are used for the presentation of material: