TABCONTROL
|
Syntax: |
TABCONTROL([<WAIT|NOWAIT>,<Exit
Macro>,<Split Handle>],
<Type>, <Row>, <Column>, <Height>, <Width>,
<Tabs per Line>, <#Mask Number> [,<#Mask
Number>])
|
||||||||||||||||||||
|
|
|
||||||||||||||||||||
|
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: |
|
||||||||||||||||||||
|
Sample: |
H% = TABCONTROL(0,5,10,10,30,3,#20,#30,#40,#50) IF H% <> 0 THEN ... Error ... ENDIF |
||||||||||||||||||||
|
See also: |
TABCONTROL_TAB_BACKGROUNDCOLOR TABCONTROL_TAB_SELECTED_BACKGROUNDCOLOR |