<<

Inhaltsverzeichnis

Suchen

>>

 

TABCONTROL

 

 

Funktion

 

 

Syntax:

TABCONTROL([<WAIT|NOWAIT>,<Exit-Makro>,<Split-Handle>], <Typ>, <Zeile>, <Spalte>, <Höhe>, <Breite>, <Reiter pro Zeile>, <#Maskennummer> [,<#Maskennummer>]...)

 

<Exit-Makro>

= <MAKRONAME>

<Split-Handle>

= <NUM-AUSDRUCK>

<Typ>

= <NUM-AUSDRUCK>

<Zeile>

= <NUM-AUSDRUCK>

<Spalte>

= <NUM-AUSDRUCK>

<Höhe>

= <NUM-AUSDRUCK>

<Breite>

= <NUM-AUSDRUCK>

<Reiter pro Zeile>

= <NUM-AUSDRUCK>

<Maskennummer>

= <NUM-AUSDRUCK>

 

 

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:

 

0:

Kein Fehler bei WAIT

<Nr>:

Identifizierungsnummer (Handle) des Tabcontrol bei NOWAIT

-2:

Laufzeitfehler

-1:

Die Variable OK enthält eine der folgenden Fehlernummern:

7810: Ein Tabcontrol kann nur auf einer Maske erzeugt werden.

7820: Die aktuelle Maske wurde nicht gefunden.

 

Parameter:

WAIT|NOWAIT

WAIT: Die Funktion kehrt erst zurück, wenn der Tabcontrol beendet wurde.

NOWAIT: Der Tabcontrol wird gestartet und die Funktion kehrt sofort zurück.

Exit-Makro

Name des Exit-Makros

Split-Handle

Identifizierungsnummer eines Splitwindows, in dem der Rabcontrol angezeigt werden soll.

Typ

Legt die Anordnung der Karteikartenreiter fest:

0: Die Variable EBUS_TABCONTROL legt die Anordnung fest.

2 = unten

3 = links

4 = rechts

sonst = oben

 

Bei Html-Programmen können die Reiter nur oben und unten angeordnet werden:

2 = unten

sonst = oben

 

Zeile

Zeilenposition des Datenbereichs des Tabcontrols

Spalte

Spaltenposition des Datenbereichs des Tabcontrols

Höhe

Höhe des Datenbereichs in Zeilen

Breite

Breite des Datenbereichs in Spalten

Reiter pro Zeile

Legt die Anzahl der Karteikartenreiter fest.

Maskennummer

Maskennummer

 

Beispiel:

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

IF H% <> 0

THEN ... Fehler ...

ENDIF

 

Siehe auch:

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