Windows control - Check button

Windows control - Check button is used to display and modify binary information - information of logical type. Checked button represents the value True, 1 or other value than 0 (zero), unchecked represents the value False or 0 (zero) or an invalid value.
Button is controlled by the mouse or, if it is active, by using the Spacebar key. The button is disabled if the value is different than 0 or 1.

Example

To create check button

1. In the Drawing toolbar click the button Check button .
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.

Check button parameters are being configured in the palette Connect object through the following tabs:

Connect

Connected object

Selection of an object to connect. The object determines the value of the check button and vice versa - the value of the object is being changed when the user checks / unchecks the check button. The value type of the object must be logical or integer.

When you connect an object of Structured variable, you must define whose item will be connected to the check button. 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 which array item will be connected to the check button.

Script

Reference variable

Specifies the name of the checkbox 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 an active picture event for the checkbox. 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 check button 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

Definition of the string, that will be displayed beside the check button. 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.

You can also define a hotkey - underlined character. Possibility to use the Dictionary (to open press CTRL+L).
You can also define a hotkey - underlined character. To create an underline character enter the character & (ampersand) before required character. The hotkey (ALT+hotkey) performs the same effect as clicking the button.

Note: Using hotkeys does not work in pictures of MDI type (the parameter Window type - the option MDI window), if such a picture is not a subpicture.

Appearance of the checkbox - classic appearance (see the picture in Example above - the checkboxes in the "Favourite newspaper" part) or button appearance (see the picture in Example above - the buttons in the "Favourite TV station" part).

Visible

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

Disabled

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

Group

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

Transparent

Transparent background of the checkbox.

Note: Transparent background is used for displaying on the monitor only (not for print).

Bmp

Clicking the button placed right opens list of bitmaps. Selected bitmap will be displayed beside the button in process D2000 HI (if the parameter Text is defined, the string defined in it will not be visible on the button).

Note relating to D2000 Thin Client

Parameter Bmp is not supported in Thin Client.
For more rules see the page Drawing rules and object properties for D2000 Thin Client.

Bmp2

Clicking the button placed right opens list of bitmaps. Selected bitmap will be displayed beside the button in process D2000 HI if the button is disabled (the parameter Disabled checked).

Font

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