SELECTA
|
Syntax: |
SELECTA([<WAIT|NOWAIT>, <Exit Macro>,
<Split Handle>],
<Array>,<Default Value>, <Count>, <Header>,
<Column Headers>, <Color Column Headers> [,<@Image Separator>, <Image
Display>] [,<Separator> [,<Minimum Rows> [,<Color Separator>]]])
|
||||||||||||||||||||||||||||
|
|
|
||||||||||||||||||||||||||||
|
Meaning: |
SELECTA
öffnet ein Fenster, in dem die Daten aus einem eindimensionalen String-Array
angezeigt werden. WINDOWPOS legt die Position des SELECTA-Windows
fest. SELECTA
arbeitet in der gleichen Weise wie die Funktion SELECT. SELECTA
wird wie ein Maskenfeld auf der aktuellen Maske eingefügt, wenn folgende 3
Bedingungen erfüllt sind: 1.
Der Parameter NOWAIT ist angegeben. 2.
Die Überschrift ist der Leerstring "". 3.
DISABLE WINDOW_BORDER ist gesetzt. oder
wenn folgende 2 Bedingungen erfüllt sind: 1.
Der Parameter NOWAIT ist angegeben. 2.
Die Variable EBUS_CHILDWINDOW ist
ungleich 0. In
diesem Fall kann der SELECTA wie die anderen Felder der Maske mit den Tasten <→|>, <↓>, etc. angesprungen
werden. Im <Exit Macro> enthält die Variable EBUS_DATA den Returncode des SELECTA. Bei
NOWAIT wird der SELECTA gestartet und die Funktion kehrt sofort zurück und
liefert die Identifizierungsnummer (Handle) des SELECTA. Mit der Anweisung CLOSE_SELECT(<Handle>) kann ein mit
NOWAIT geöffneter SELECTA geschlossen werden. Bei
WAIT wird SELECTA hierarchisch gestartet: Die Funktion kehrt erst zurück,
wenn der SELECTA beendet wurde. Der
Macro <Exit Macro> wird ausgeführt, nachdem der SELECTA beendet wurde,
sei es durch Schließen des Windows, durch Verlassen mit ESC oder die
Anweisungen ENDSELECT oder QUITSELECT. Wird
WAIT oder NOWAIT angegeben, so muss auch ein <Exit Macro> angegeben
werden. Bei NOWAIT enthält im <Exit Macro> die Variable EBUS_DATA den
Returncode des SELECTA. Wenn
der SELECTA im split window angezeigt werden soll, muss <Split-Handle>
die Identifizierungsnummer des split windows enthalten, andernfalls ist
<Split-Handle> = 0 zu setzen. Fehlen
die Parameter [WAIT | NOWAIT,<Exit Macro>,<Split-Handle>], so ist
dies gleichbedeutend mit WAIT. Alle
Schalter und ON <Event> Macros werden bei
NOWAIT beim Start des SELECTA und bei jedem Verlassen des SELECTA gesichert.
Beim erneuten Aktivieren des SELECT wird der letzte Zustand der Schalter und
ON <Event> Macros wieder hergestellt. Nach jedem ON
SELECT(<Key>) Macro, der im SELECTA ausgeführt wird, werden die ON
<Event> Macros erneut gesichert. <Array>
ist der Name der Variablen eines eindimensionalen String-Arrays. Es ist nur
der Name der Variablen ohne Indizes anzugeben. Jedes Element von
<Array> wird als eine Zeile im SELECTA angezeigt. Der Inhalt einer
Zeile kann durch das 1. Zeichen von <Separator> in beliebig viele
Felder unterteilt werden, die dann in Spalten angezeigt werden. Mehrzeilige
Texte können im SELECTA angezeigt werden. Durch EBUS_LINEFEED$ oder durch <html> …
<br> … </html> kann ein Zeilenumbruch erzeugt werden. Sample: DIM ARRAY$(10) ARRAY$(1) = "This is a text" + EBUS_LINEFEED$ + "with 2 lines." ARRAY$(2) = "<html>This is also a
text<br>with 2 lines.</html>" Bei
<Default Value> kann ein beliebiger String-Ausdruck angegeben werden.
Beim Aufruf der Funktion SELECTA werden alle Einträge in <Array> mit
<Default Value> verglichen. Bei Gleichheit wird das gefundene
Tabellenelement markiert dargestellt. Ist <Default Value> der
Leerstring "" oder wird in der Tabelle kein Element gefunden, das
gleich <Default Value> ist, so wird das erste Element der Tabelle
markiert dargestellt. Es können als <Default Value> mehrere Zeilen
markiert dargestellt werden. Die Einträge in <Default Value> müssen
dazu durch CHR$(9) (TAB) getrennt sein. <Count>
ist die Anzahl der Elemente, die von SELECTA verwendet werden. Das erste
Element in der Tabelle ist das Element Nr. 1. Das Element Nr. 0 wird von
SELECTA nicht verwendet. Es ist sicherzustellen, dass ein korrekter Wert
übergeben wird. Es wird nicht geprüft, ob <Count> größer als die
Dimensionierung der Variablen ist. Ist dies der Fall, so werden
Laufzeitfehler gemeldet. <Header>
legt die Windowüberschrift fest. <Column
Headers> legt die Überschriften der Spalten fest. Enthält <Column Headers>
den Leerstring "", so wird keine Spaltenüberschriftzeile angezeigt. <Color Column Headers> legt die Farbe der Spaltenüberschriftzeile fest. Es ist die Nummer einer RGB-Farbe anzugeben. Ist <Color Column Headers> < 0 oder > 255, so wird RGB(0) verwendet. Im
SELECTA können auch Bilder angezeigt werden. Dazu muss ein @<Image
Separator> angegeben werden. Das Zeichen @ dient der Kennzeichnung des
Bildtrennzeichens. Beginnt ein Feld mit diesem Zeichen, so wird der Text nach
diesem Zeichen als interpretiert und das Bild anstelle des Textes angezeigt. <Image
Display> legt fest, wie das Bild angezeigt wird:
<Separator>
kann bis zu 4 Separators enthalten: Das 1.
Zeichen in <Separator> trennt die Felder in den Elementen von
<Array> und in den <Column Headers>. Es werden dann entsprechend
viele Spalten angezeigt. Enthält <Separator> den Leerstring
"", so wird im SELECTA nur eine Spalte angezeigt. Das
2. Zeichen in <Separator> legt fest, welche Feldinhalte rechtsbündig
angezeigt werden sollen. Das Zeichen muss in den Elementen von <Array>
beim jeweiligen Feldwert als erstes Zeichen angegeben werden. Standardmäßig
erfolgt die Anzeige eines Feldinhalts linksbündig. Das
3. Zeichen in <Separator> legt fest, welche Feldinhalte zentriert
angezeigt werden sollen. Das Zeichen muss in den Elementen von <Array>
beim jeweiligen Feldwert als erstes Zeichen angegeben werden. Das
4. Zeichen in <Separator> kennzeichnet Checkboxen. Es kann nur in den <Column
Headers> angegeben werden und gilt für die gesamte Spalte. Es werden dann
alle Elemente der Spalte als Checkbox angezeigt. Eine Checkbox wird als
gesetzt angezeigt, wenn das 1. Zeichen des Spaltenelementes das Zeichen CHR$(EBUS_CHECKBOX_Y)
ist. Ist das Spaltenelement einer Checkbox der Leerstring "", so
wird keine Checkbox sondern ein leeres Feld angezeigt. Die
Separators für rechtsbündig und zentriert können auch in den <Column
Headers> angegeben werden. Sie gelten dann für alle Elemente der Spalte
mit Ausnahme der Elemente, bei denen ein eigenes Separator angegeben ist. Wird
für ein Spaltenelement zusätzlich ein <Color Separator> angegeben, so
muss das Separator für rechtsbündige oder zentrierte Anzeige nach dem
<Color Separator> stehen. <Minimum
Rows> legt fest, wie viele Zeilen im SELECTA-Fenster mindestens angezeigt
werden. Zeilen,
Spalten oder einzelnen Spaltenelementen können durch Voranstellung eines
Farbcodes Farben zugeordnet werden. Der Farbcode setzt sich zusammen aus dem
ersten Zeichen von <Color Separator> und einer <Color>. <Color>
enthält in spitzen Klammern <Foreground Color , Background Color>. Als Vordergrundfarbe und Hintergrundfarbe
muss die Nummer einer RGB-Farbe oder eine negative
Zahl angegeben werden. Bei einer negativen Zahl wird die entsprechende Farbe
nicht gesetzt, es gilt dann die Standardvordergrundfarbe bzw.
Standardhintergrundfarbe. Beispiel: Das Farbzeichen ist @ RGB(1) = 255,0,0 /*
red RGB(2) = 0,0,255 /*
blue @<1,2> specifies red on blue @<1,-1> sets the foreground to red, the
background remains unchanged @<-1,1> sets the background to red, the
foreground remains unchanged Farben
können auch in den <Column Headers> angegeben werden. Sie gelten dann
für alle Elemente der Spalte mit Ausnahme der Elemente, bei denen eine eigene
Farbe angegeben ist. Die
Farbe für ein einzelnes Spaltenelement (Feld) wird dadurch festgelegt, dass
dem Spaltenelement ein Farbcode vorangestellt wird. Die
Farbe für eine gesamte Zeile wird dadurch festgelegt, dass der Zeile ein
Farbcode vorangestellt wird. Diese Farbcode gilt dann für alle Felder dieser
Zeile. Jedem Feld der Zeile, das normal oder in einer anderen Farbe dargestellt
werden soll, muss deshalb ein eigener Farbcode vorangestellt werden. Eine
normale Anzeige eines Feldes (ohne Farbe) wird durch <Color
Separator><-1,-1> erreicht. Achtung: Die Farbe für das erste
Feld einer Zeile gilt immer für die gesamte Zeile. Sollen die weiteren
Felder einer Zeile keine Farbe erhalten, so muss bei jedem Feld <Color
Separator><-1,-1> angegeben werden. Da
sowohl Zeilen als auch Spalten und Feldern verschiedene Farbcodes zugeordnet
werden können, gelten folgende Prioritätsregeln: Die
höchste Priorität für die Farbe eines Feldes hat der Farbcode des Feldes. Ist
für ein Feld keine Farbe definiert, so gilt die Farbe der Spalte. Ist
auch keine Spaltenfarbe festgelegt, so gilt die Farbe der Zeile. Der
ON SELECT(MOUSE) Macro wird im
SELECTA ausgeführt, wenn die linke Maustaste betätigt wurde und gleichzeitig
eine oder mehrere der Tasten SHIFT, Alt oder Strg gedrückt sind. In den ON SELECT(...)
Macros können die
Variablen EBUS_SELECT_POS und EBUS_SELECTA gesetzt
werden. Nach der Ausführung des Macros wird die entsprechende Zeile markiert. Die
Variable EBUS_SELECT_FIXCOLUMNS
legt fest, welche Spalten des SELECTA fixiert werden. Fixierte Spalten
bleiben immer sichtbar, auch wenn der horizontale Scrollbalken des SELECTA
nach rechts verschoben wird. SELECTA
liefert folgende Ergebniswerte: -1:
Fehler: <Anzahl> <= 0 >
0: SELECTA liefert die Nummer des Array-Elementes, das ausgewählt wurde. 0:
Es wurde kein Element ausgewählt, SELECTA wurde mit <Esc> oder QUITSELECT verlassen. |
||||||||||||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||||||||||||
|
Sample: |
DIM T$(10) /* specifiy colors RGB(0) = 0,0,0 /* black RGB(2) = 0,128,0 /* green RGB(4) = 128,0,0 /* red RGB(5) = 255,0,0 /* light red RGB(6) = 255,255,0 /* yellow RGB(15)
= 255,255,255 /* white WHITE_RED$
= "\<15,4>" BLACK_YELLOW$
= "\<0,6>" WHITE_GREEN$
= "\<15,2>" WHITE_LIGHTRED$ = "\<15,5>" T$(1)
= WHITE_RED$ + "dark red;" + BLACK_YELLOW$ + "yellow;" + WHITE_GREEN$ + "green in red
column" T$(2)
= BLACK_YELLOW$ + "yellow;" + WHITE_LIGHTRED$ + "light red;red column line 2" T$(3)
= WHITE_GREEN$ + "green;\<-1,-1>normal;red column line 3" T$(4)
= "normal;" + WHITE_LIGHTRED$ + "ligth red;red column line
4" T$(5)
= WHITE_LIGHTRED$ + "This line is light red" T$(6) = "\<2,-1>Only
text is green." SELECTFONT
= 0 WINDOWPOS(0,0) H%
= SELECTA(T$,"",10,"Color
in SELECTA", "Column 1;Column 2;"
+ WHITE_RED$ + "@dark red column right
aligned",
0,";@",0,"\")
/* Color in SELECTA
without columns DIM T$(10) /* specifiy colors RGB(0) = 0,0,0 /* black RGB(2) = 0,128,0 /* green RGB(4) = 128,0,0 /* red RGB(5) = 255,0,0 /* light red RGB(6) = 255,255,0 /* yellow RGB(15) =
255,255,255 /* white WHITE_RED$ = "\<15,4>" BLACK_YELLOW$ = "\<0,6>" WHITE_GREEN$ = "\<15,2>" WHITE_LIGHTRED$ = "\<15,5>" T$(1) = "This line is normal" T$(2) = WHITE_RED$ + " This line is red." T$(3) = BLACK_YELLOW$ +
" This line is
yellow." T$(4) = WHITE_GREEN$ + " This line is green." T$(5) = WHITE_LIGHTRED$
+ " This line is
light red. " T$(6) = "\<2,-1>Only text is green." SELECTFONT
= 0 WINDOWPOS(0,0) H% = SELECTA(T$,"",10,"Color in SELECTA","",0,"",0,"\")
|
||||||||||||||||||||||||||||
|
See
also: |
|