Windows control - Push button

Windows control - Push button is used to generate a picture event after pressing the button. The event can be handled in the picture script.

Example

To create push button

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

Button 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 (parameter Column) and the row number (parameter Row). For object of Value array you must define an item.

Control

The palette for button as one of the Windows controls contains the tab Control. The tab allows to define an object, that will be directly controlled with no need to define the action in the picture script. Description of the tab is in the topic Connecting graphic object to control.

Script

Reference variable

Specifies the name of the push button 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 a active picture event for the push button. The list box contains the following active picture events:

• OnClick
• OnGotFocus
• OnLostFocus
• OnMouseDown
• OnMouseEnter
• OnMouseLeave
• OnUserInput

Note relating to D2000 Thin Client

Event handler of OnUserInput is not implemented in Thin Client.
For more rules see the page Drawing rules and object properties for D2000 Thin Client.

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 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

A string, that will be displayed on the push 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.

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

You can also define a hotkey for the button - underlined character. To create an underline character enter the character & (ampersand) before required character.
The button displayed above contains the underlined character O, so the hotkey is ALT+O. The hotkey performs the same effect as clicking the button.

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

Visible

If the parameter is checked, the push button 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 push button 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 push button as the first control of a group of Windows controls.

Enter

Definition button for Enter.

Esc

Definition button for Esc.

Support for the Enter and Esc keys works under the following conditions:

1. It works for dialog pictures and the subpictures of dialog-modal windows only.
2. The button "OK" is to be created as the first picture element (ID = GO number = 1) - can be invisible. The button gets message from the Enter key as defined for dialog windows in the Windows operating systems.
3. The button "CANCEL" is to be created as the second picture element "CANCEL" (ID = GO number = 2) - can be invisible. The button gets message from the Esc key.
4. Pressing the Enter and Esc keys for the buttons defined in this way is concerning the main picture defined as a dialog one or a subpicture of a dialog-modal picture.

Note relating to D2000 Thin Client

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

Bmp

Clicking the button placed right opens a list of bitmaps. Selected bitmap will be displayed on 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

It is not possible to align bitmap in button vertically 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 a list of bitmaps. Selected bitmap will be displayed on the button in process D2000 HI if the button is disabled (the parameter Disabled checked).

Note: In use of a color bitmap, Windows systems converts it to a monochromatic one, and therefore we recommend you to use monochromatic bitmaps to avoid distortion of color bitmap.

Note relating to D2000 Thin Client

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

Font

Clicking the button placed right opens a list of text fonts. A font selected from the list will be used for the button 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.