TABCONTROL
|
Syntax: |
TABCONTROL([<WAIT|NOWAIT>,<Exit-Makro>,<Split-Handle>], <Typ>, <Zeile>, <Spalte>,
<Höhe>, <Breite>, <Reiter pro Zeile>, <#Maskennummer>
[,<#Maskennummer>]...)
|
||||||||||||||||||||
|
|
|
||||||||||||||||||||
|
Bedeutung: |
Erzeugt
einen Tabcontrol. Bei
NOWAIT wird der Tabcontrol wie ein Maskenfeld auf der aktuellen Maske
eingefügt und kann wie die anderen Felder der Maske mit den Tasten <→|>, <↓>, etc. angesprungen
werden. Beendet wird ein NOWAIT-Tabcontrol nicht mit der Taste <Esc>,
sondern nur durch CLOSE_TABCONTROL
oder ENDPROG. Bei
NOWAIT wird der Tabcontrol gestartet und die Funktion kehrt sofort zurück und
liefert die Identifizierungsnummer (Handle) des Tabcontrol. Bei
WAIT wird der Tabcontrol hierarchisch gestartet: Die Funktion kehrt erst
zurück, wenn der Tabcontrol beendet wurde. Der Makro
<Exit-Makro> wird ausgeführt, nachdem der Tabcontrol beendet wurde. Wird
WAIT oder NOWAIT angegeben, so muss auch ein <Exit-Makro> angegeben
werden. Wenn
der Tabcontrol im Splitwindow angezeigt werden soll, muss
<Split-Handle> die Identifizierungsnummer des Splitwindows enthalten,
andernfalls ist <Split-Handle> = 0 zu setzen. Fehlen
die Parameter [WAIT | NOWAIT,<Exit-Makro>,], so ist dies
gleichbedeutend mit WAIT. <Zeile>
und <Spalte> legen die linke obere Ecke des Datenbereichs des
Tabcontrols fest. Der Datenbereich beginnt direkt unter den
Karteikartenreitern. Da die Anzeige im aktuellen Window bzw. Mainwindow
erfolgt, wird die Position des Datenbereichs des Tabcontrols relativ zur
linken oberen Ecke des Windows angegeben, d.h. das 1. Zeichen oben links im
Window hat die Koordinaten (1,1). <Höhe>
und <Breite> legen die Größe des Datenbereichs in Zeilen und Spalten
fest. Die
Höhe der Karteikartenreiter wird durch die Variable EBUS_TABCONTROL_HEADERSIZE und die
Schriftgröße im Karteikartenreiter durch die Variable EBUS_TABCONTROL_TEXTSIZE festgelegt. Die Schriftart wird durch die Anweisung TABCONTROL_HEADERFONT festgelegt. Bei
Tabcontrols können Bilder im Karteikartenreiter angezeigt werden. Der Name
der Bilddatei muss vor der Maskenüberschrift angegeben werden. Vor dem
Bildnamen muss das Zeichen '@' und danach das Zeichen ',' stehen. Die
Variable EBUS_TABCONTROL_IMAGEMODE
legt fest, wie die Bilder im Karteikartenreiter angezeigt werden. Beispiel: Maskenüberschrift:
@XY.gif,Eigenschaften: Im Karteikartenreiter wird das Bild XY.gif und der
Text "Eigenschaften" angezeigt. <Reiter pro Zeile> legt fest, wie viele Karteikartenreiter maximal nebeneinander angereiht werden. Sind mehr Maskennummern als <Reiter pro Zeile> angegeben, so erfolgt die Anzeige der Karteikartenreiter mehrstufig hintereinander. Ist <Reiter pro Zeile> <= 0, so werden jeweils so viele Karteikartenreiter nebeneinander angereiht wie aufgrund der Breite der Überschriften möglich sind. Ist <Reiter pro Zeile> < 0 und passen nicht alle Karteikartenreiter in eine Zeile, so kann in den Karteikartenreitern gescrollt werden. Es können beliebig viele Maskennummern angegeben werden. Es spielt keine Rolle, ob eine Maske als Mainwindow oder Window definiert ist. TABCONTROL
lädt die jeweils ausgewählte Maske in den Datenbereich und startet die
Feldverarbeitung. Ist der Datenbereich zu klein für die Maske, so werden
überstehende Texte und Maskenfelder abgeschnitten. Die abgeschnittenen
Maskenfelder werden aber in der Feldverarbeitung trotzdem angesprungen, auch
wenn sie nicht sichtbar sind. Die
Feldverarbeitung erfolgt bei TABCONTROL genauso wie bei allen anderen Masken.
Der
Makro vor Maskenausgabe wird nur einmal beim Erzeugen des
Tabcontrols ausgeführt. Beim späteren Aktivieren einer Tabcontrolmaske wird
der Makro vor Maskenausgabe nicht mehr ausgeführt. Dagegen wird
der Makro nach Maskenausgabe jedesmal ausgeführt, wenn die
Maske aktiviert wird. TABCONTROL
liefert folgende Ergebniswerte:
|
||||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||||
|
Beispiel: |
H% = TABCONTROL(0,5,10,10,30,3,#20,#30,#40,#50) IF H% <> 0 THEN ... Fehler ... ENDIF |
||||||||||||||||||||
|
Siehe
auch: |
TABCONTROL_TAB_BACKGROUNDCOLOR TABCONTROL_TAB_SELECTED_BACKGROUNDCOLOR |