Windows control - Tab control

Windows control - Tab control is used to create a table with tabs. These individual tabs allow to display objects of Picture or Graph types.

Example

To create tab control

In the Drawing toolbar click the button Tab control .
Point the mouse cursor to the position of the first tab control corner and click.
Point the mouse cursor to the position of the diametric tab control corner and click.

Tab control parameters are being configured in the palette Connect object through the following tabs:

Connect

Connected object

The parameter is not being configured for this type of Windows control.

Script

Reference variable

Specifies the name of the tab control 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 tab control. The list box contains the following active picture events:

Note relating to D2000 Thin Client

Event handler OnGotFocus and OnLostFocus 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 tabs 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

The parameter is useless for this type of Windows control.

Visible

This parameter is disabled. It is set on visible, e.g. the tab control will be visible after first opening the picture in process D2000 HI.

Disabled

This parameter is disabled. The tab control will be always enabled after first opening the picture in process D2000 HI.

Group

This parameter is disabled. The parameter allows you to set the tab control as the first control of a group of Windows controls.

Tabs

The button allows you to define the properties of individual tabs. Clicking on the button opens the following dialog box:

Defining the tabs properties

Placement - defines where defined tabs of the tab control appears - Top, Bottom, Left and Right

Multiline - allows to display multiple rows of tabs, if necessary, so all tabs are visible at once

Fixed width - all tabs are the same width

Active - number of the tab that to be displayed after opening the tab control in the process D2000 HI

The following buttons allows to add or delete tabs (rows in the table:

	Adds new tab.
	Removes selected tab.

The buttons Button Move upward and Button Move downward allows to change the order of the tabs.

Description of the table columns in the dialog box:

Column	Meaning
Nr.	Order of tabs in the tab control.
Visible	Shows / hides the tab.
Disabled	Connected object is disabled.
Name	Tab name.
Connected object	Name of the object connected to view in the tab. Double-clicking the input field opens a list of object.
Object type	Type of the object to be displayed in the tab. Possible types: Picture and Graph. Note: Object type is defined automatically by the object to be displayed in the tab (the column Connected object). If there is no object defined, you must defined an object type for use in the picture script.
Open	Defines when the connected object will be displayed: immediately - object is to be displayed in the tab immediately after opening the tab control in the process D2000 HI later - object is to be displayed after selecting the tab
Reference variable	Name of the reference variable assigned to the tab for use in the script. Clicking the name of particular tab generate the picture event OnClick.
Parameter	The column contains a parameter that is defined in the next two column (the columns Inherited and Defined). The parameter depends on the object type: for pictures - Instance for graphs - Line nr.
Inherited	for pictures - if the parameter is checked, the instance number of the picture displayed in the tab will be the same as the instance number of the picture containing the tab control for graphs - if the parameter is checked, the row number of all active graph objects in the graph will be derived from the current picture instance number. For active graph only. Note: Row number can be also changed from the picture script using the function %HI_SetGraphRowNr.
Defined	for pictures - allows to defined the instance number of the picture for graphs - allows to define the row number of all active graph objects in the graph directly. For active graph only.
Parameter	The column contains the parameter (Multiple open or Show control) depending on the object type: for pictures - enables / disables multiple opening of the subpicture with the same instance number in several pictures for graphs - shows / hides the graph controls

Font

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

Control the tab in Windows control of Tab type

Define the object to display in tab	To display an object in given tab use the function %HI_SetConnectedObj. Note: Type of the object defined to display in the tab from the script must be the same as the object type defined for the tab (the parameter Object type).
Show / hide a tab	To show / hide a tab from the picture script use the function %HI_SetVisible.
Enable / disable a tab	To enable / disable an access to the contents of tab from the picture script, use the function %HI_SetEnable.
Set tab name	To set the tab from the picture script use the function %HI_SetText.
Select active tab	To select the active tab from the picture script use the function %HI_SetFocus.

Note:
The selecting a tab generates the picture event OnClick. The picture event is also generated when given tab was removed (made invisible) using the function %HI_SetVisible (actually, the user chose another tab) - there is generated the picture event for the first visible tab from the left.

Strom stránky

Tab Control