Windows control - Tab control


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


Example

Example - Tab control

To create a tab control


  1. In the Drawing toolbar click the button Tab control Tab control.
  2. Point the mouse cursor to the position of the first tab control corner and click.
  3. 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 a 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 on the button. Multiple records are indicated by ",...".


Event


The list box allows users to select active picture events for the tab control. The list box contains the following active picture events:



Note relating to D2000 Thin Client


Event handlers OnGotFocus and OnLostFocus are not implemented in the Thin Client.
For more rules see the page Drawing rules and object properties for the 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 the user points the mouse cursor to the tabs in the picture opened in the D2000 HI process.


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 also be set 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 the D2000 HI process.


Disabled


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


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:



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


Multiline - allows the display of 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 is to be displayed after opening the tab control in the D2000 HI process


The following buttons allow 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:


ColumnMeaning
Nr.Order of tabs in the tab control.
VisibleShows/hides the tab.
DisabledConnected object is disabled.
NameTab name.
Connected objectName of the object connected to view in the tab. Double-clicking the input field opens a list of objects.
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 define an object type for use in the picture script.

OpenDefines when the connected object will be displayed:
  • immediately - object is to be displayed in the tab immediately after opening the tab control in the D2000 HI process.
  • later - object is to be displayed after selecting the tab
Reference variableName of the reference variable assigned to the tab for use in the script. Clicking the name of a particular tab generates the picture event OnClick.
ParameterThe column contains a parameter that is defined in the next two columns (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.
ParameterThe column contains the parameter (Multiple open or Show control) depending on the object type:
  • for pictures - enables/disables multiple openings 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 tabTo display an object in given tab use the function %HI_SetConnectedObj.

Note: The 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 tabTo show/hide a tab from the picture script use the function %HI_SetVisible.
Enable/disable a tabTo enable/disable access to the contents of the tab from the picture script, use the function %HI_SetEnable.
Set tab nameTo set the tab from the picture script use the function %HI_SetText.
Select active tabTo select the active tab from the picture script use the function %HI_SetFocus.


Note:
Selecting a tab generates the picture event OnClick. The picture event is also generated when the given tab is 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.


Write a comment...