<<

Contents

Search

>>

 

TABCONTROL

 

 

Function

 

 

Syntax:

TABCONTROL([<WAIT|NOWAIT>,<Exit Macro>,<Split Handle>], <Type>, <Row>, <Column>, <Height>, <Width>, <Tabs per Line>, <#Mask Number> [,<#Mask Number>])

 

<Exit Macro>

= <MACRONAME>

<Split Handle>

= <NUM-EXPRESSION>

<Type>

= <NUM-EXPRESSION>

<Row>

= <NUM-EXPRESSION>

<Column>

= <NUM-EXPRESSION>

<Height>

= <NUM-EXPRESSION>

<Width>

= <NUM-EXPRESSION>

<Tabs per Line>

= <NUM-EXPRESSION>

<Mask Number>

= <NUM-EXPRESSION>

 

 

Meaning:

Creates a Tabcontrol.

 

With NOWAIT the tabcontrol is inserted on the current mask like a mask field and can be called like the other fields of the mask with the keys <→|>, <←>, etc. A NOWAIT tabcontrol is not terminated by the key <Esc> but only by CLOSE_TABCONTROL or ENDPROG.

 

With NOWAIT the tabcontrol is started and the function is terminated immediately and returns the handle of the tabcontrol. 

 

With WAIT the tabcontrol is started hierarchically: The functions is only terminated if the tabcontrol has been terminated.

 

The Macro <Exit Macro> is executed after the tabcontrol has been terminated.

 

If WAIT or NOWAIT is specified, an <Exit Macro> must be specified as well.

 

If the tabcontrol is to be displayed in the split window, <Split Handle> must contain the handle of the split window, otherwise <Split Handle> must be set to 0.

 

If the parameters [WAIT | NOWAIT,<Exit Macro>,] are missing, this is equivalent to WAIT.

 

<Row> and <Column> specify the upper left corner of the data area of the tabcontrol. The data area begins right under the tabs . Since the data is displayed in the current window or main window the position of the data area of the tabcontrol is specified in relation to the upper left corner of the window, that means the 1st character in the upper left corner of the window has the coordinates (1,1).

 

<Height> and <Width> define the size of the data area in rows and columns.

 

The height of the Tabs is defined by the variable EBUS_TABCONTROL_HEADERSIZE and the font size in the Tab is defined by the variable EBUS_TABCONTROL_TEXTSIZE. The font type is defined by the instruction TABCONTROL_HEADERFONT.

 

With tabcontrols images can be displayed in the Tab. The name of the image file must be specified before the mask title. The charcater ‚@’ must stand before the image name and the character ',' must come after the image name. The variable EBUS_TABCONTROL_IMAGEMODE specifies how the images are displayed in the Tab.

Example: Mask title: @XY.gif,properties: In the Tab the image XY.gif and the text "Properties" are displayed.

 

<Tabs per Line> specifies the maximum number of Tabs that are stringed together. If more mask numbers than <Tabs per Line> are specified, the Tabs are arranged in several rows.

 

If <Tabs per Line> <= 0, as many Tabs are stringed together as possible considering the width of the titles. If <Tabs per Line> < 0 and if not all Tabs fit into one line, the Tabs can be scrolled within.

 

Any number of mask numbers can be specified. It is not relevant if a mask is defined as main window or window.

 

TABCONTROL loads the selected mask into the data area and starts the field processing. If the data area is too small for the mask, only those parts of the texts and mask fields that fit into the area are displayed. The cut off mask fields are nevertheless called in the field processing even though they are not visible.

 

With TABCONTROL field processing is the same as with all other masks.

 

The Macro Before Mask is only executed once when the tabcontrol is created. When a tabcontrol mask is activated later the Macro Before Mask is not executed anymore. However, the Macro after Mask is executed every time the mask is activated.

 

TABCONTROL returns the following values:

 

0: No error with WAIT

<No>: Handle of the Tabcontrol with NOWAIT

-2: Runtime error

-1: Error: The variable OK contains one of the following error numbers:

                 7810: A Tabcontrol can only be created on a mask.

                 7820: The current mask has not been found.

 

Parameter:

WAIT|NOWAIT

WAIT: The function is only terminated when the Tabcontrol is terminated.

NOWAIT: The Tabcontrol is started and the function is terminated immediately.

Exit Macro

Name of Exit Macro

Split Handle

Handle of the split windows in which the TABCONTROL is to be displayed.

Type

Defines the configuration of the Tabs:

0: The variable EBUS_TABCONTROL specifies the configuration.

2 = bottom

3 = left

4 = right

otherwise = top

 

In Html Programs the Tabs can be located only on top and bottom:

2 = bottom

otherwise = top

 

Row

Row position of the data area of the Tabcontrol

Column

Column position of the data area of the Tabcontrol

Height

Height of the data area in rows

Width

Width of the data area in columns

Tabs per Line

Defines the number of Tabs

Mask Number

Mask number

 

Sample:

H% = TABCONTROL(0,5,10,10,30,3,#20,#30,#40,#50)

IF H% <> 0

THEN ... Error ...

ENDIF

 

See also:

CLOSE_TABCONTROL

TABCONTROL_HEADERFONT

ACTIVATE_TABCONTROL

ENABLE_TABCONTROL,

DISABLE_TABCONTROL,

EBUS_TABCONTROL_HEADERSIZE

EBUS_TABCONTROL_TEXTSIZE

EBUS_TABCONTROL_IMAGEMODE

EBUS_TABCONTROL

EBUS_CHILDWINDOW

GET_TABCONTROL_SIZE

SET_TABCONTROL_SIZE

TABCONTROL_BACKGROUNDCOLOR

TABCONTROL_TAB_BACKGROUNDCOLOR

TABCONTROL_TAB_TEXTCOLOR

TABCONTROL_TAB_SELECTED_BACKGROUNDCOLOR