Windows control - Group box

Windows control - Group box is used for a group of a set of graphic objects. Group box marks graphic objects, which are used for one defined purpose.

Example

To create group box

1. In the Drawing toolbar click the button Group box .
2. Point the mouse cursor to the position of the first displayer corner and click.
3. Point the mouse cursor to the position of the diametric displayer corner and click.

Group box parameters are being configured in the palette Connect object through the following tabs:

Connect

The Windows control has no value and therefore the parameters on this tab are meaningful only for the description of the Windows control (see the parameter Text)

Connected object

Selection of an object to connect.
When you connect an object of Structured variable you must define an item. Unique item position in structured variable is defined by the column name (the parameter Column) and the row number (the parameter Row). For object of Value array you must define an item.

Script

Reference variable

Specifies the name of the group box in the form of reference variable for use in the picture script.

Metadata

Assignment of application data (metadata) to a graphic object. If the object contains some metadata, the name of the first record will be displayed in the button. Multiple records are indicated by ",...".

Event

The list box allows user to select active picture event for the group box. The list box contains the following active picture events:

• OnClick
• OnGotFocus
• OnLostFocus

Event Handler

The button opens the active picture script to define the active picture event specified by the parameter Event.

Info text/URL

Info text

Text to display as a tooltip when user points the mouse cursor to the group box in the picture opened in process D2000 HI.
Possibility to use the Dictionary (to open press CTRL+L).

URL

Definition of URL address to open a web page from a picture. The address may be set also in the picture script by the function %HI_SetOBJURL.

Properties

Text

A string, that will be displayed in the corner left top of the group box. The string may also display current (so-called live) values of the object defined by the parameter Connected object but such strings must be defined in a special format - for detailed information see the chapter Format masks.

Possibility to use the Dictionary (to open press CTRL+L).

Visible

If the parameter is checked, the group object will be visible after first opening the picture in process D2000 HI. The parameter can be controlled from the script using the function %HI_SetVisible.

Disabled

If the parameter is checked, the group box will be disabled after first opening the picture in process D2000 HI. The parameter can be controlled from the picture script using the function %HI_SetEnable.

Group

The parameter allows you to set the group box as the first control of a group of Windows controls.

Font

Clicking the button placed right opens a list of text fonts. A font selected from the list will be used for the group box text. For more information on text fonts see the topic Text fonts.

Note: Font can be modified (changed) from the picture script using the function %HI_SetFontStyle.

Note relating to D2000 Thin Client

In Thin Client, Group box must be placed under the objects in the picture, otherwise they need not to be manageable (ideally, at first add the Group box and then the objects).
For more rules see the page Drawing rules and object properties for D2000 Thin Client.