SELECTA
|
Syntax: |
SELECTA([<WAIT|NOWAIT>,<Exit-Makro>,<Split-Windowcall-Handle>], <Array>, <Voreinstellung>,
<Anzahl>, <Überschrift>, <Spaltenüberschriften>, <Farbe
Spaltenüberschriften> [,@<Bildtrennzeichen>,
<Bildanzeige>] [,<Trennzeichen>
[,<Mindestzeilen> [,<Farbzeichen> [,<Hilfetext-Trennzeichen>[,<Unsichtbar-Trennzeichen>]]]]])
|
||||||||||||||||||||||||||||||||
|
|
|
||||||||||||||||||||||||||||||||
|
Bedeutung: |
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. Der
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-Makro> 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
Makro <Exit-Makro> 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-Makro> angegeben
werden. Bei NOWAIT enthält im <Exit-Makro> die Variable EBUS_DATA den
Returncode des SELECTA. Wenn
der SELECTA im Splitwindow angezeigt werden soll, muss NOWAIT gesetzt sein
und <Split-Windowcall-Handle> muss die Identifizierungsnummer des
Splitwindows enthalten Wenn
der SELECTA als Maskenfeld auf einer WINDOWCALL-Maske angezeigt werden soll,
muss EBUS_CHILDWINDOW <> 0 sein
und <Split-Windowcall-Handle> muss die Identifizierungsnummer der WINDOWCALL-Maske enthalten. Fehlen
die Parameter [WAIT |
NOWAIT,<Exit-Makro>,<Split-Windowcall-Handle>], so ist dies
gleichbedeutend mit WAIT. Alle
ON <Ereignis> Makros 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
<Ereignis> Makros wieder hergestellt. Nach jedem ON
SELECT(<Taste>) Makro, der im SELECTA ausgeführt wird, werden die
ON <Ereignis> Makros 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 <Trennzeichen> 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. Beispiel: DIM ARRAY$(10) ARRAY$(1) = "Dies ist ein Text" + EBUS_LINEFEED$ + "mit 2 Zeilen." ARRAY$(2) = "<html>Dies ist auch ein
Text<br>mit 2 Zeilen.</html>" Bei
<Voreinstellung> kann ein beliebiger String-Ausdruck angegeben werden.
Beim Aufruf der Funktion SELECTA werden alle Einträge in <Array> mit
<Voreinstellung> verglichen. Bei Gleichheit wird das gefundene
Tabellenelement markiert dargestellt. Ist <Voreinstellung> der
Leerstring "" oder wird in der Tabelle kein Element gefunden, das
gleich <Voreinstellung> ist, so wird das erste Element der Tabelle
markiert dargestellt. Es können als <Voreinstellung> mehrere Zeilen
markiert dargestellt werden. Die Einträge in <Voreinstellung> müssen
dazu durch CHR$(9) (TAB) getrennt sein. <Anzahl>
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 <Anzahl> größer als die
Dimensionierung der Variablen ist. Ist dies der Fall, so werden
Laufzeitfehler gemeldet. <Überschrift>
legt die Windowüberschrift fest. <Spaltenüberschriften>
legt die Überschriften der Spalten fest. Enthält <Spaltenüberschriften>
den Leerstring "", so wird keine Spaltenüberschriftzeile angezeigt. Mehrzeilige
Spaltenüberschriften können mit Hilfe von Html erzeugt werden. Beispiel: SPALTEN_UEB$
= "<html>Monat<br>KW</html>;Umsatz;Anzahl> Die
Spaltenüberschrift ist zweizeilig. In der ersten Spalte steht 'KW' unter
'Monat'. <Farbe Spaltenüberschriften> legt die Farbe der Spaltenüberschriftzeile fest. Es ist die Nummer einer RGB-Farbe anzugeben. Ist <Farbe Spaltenüberschriften> < 0 oder > 255, so wird RGB(0) verwendet. Im
SELECTA können auch Bilder angezeigt werden. Dazu muss ein
@<Bildtrennzeichen> angegeben werden. Das Zeichen @ dient der
Kennzeichnung des Bildtrennzeichens. Beginnt ein Feld mit diesem Zeichen, so
wird der Text nach diesem Zeichen als Bild interpretiert und das Bild
anstelle des Textes angezeigt. <Bildanzeige>
legt fest, wie das Bild angezeigt wird:
Die
Anzeige linksbündig / Feldmitte hat nur eine Wirkung, wenn kein individuelles
Attribut links/rechts/zentriert für das Feld definiert ist. Es
können auch Bilder über das WEB geladen werden. Dazu muss der Bildname mit
einem der folgenden Präfixe beginnen: http: https: ftp: ftps: <Trennzeichen>
kann bis zu 4 Trennzeichen enthalten: Das 1.
Zeichen in <Trennzeichen> trennt die Felder in den Elementen von <Array>
und in den <Spaltenüberschriften>. Es werden dann entsprechend viele
Spalten angezeigt. Enthält <Trennzeichen> den Leerstring "",
so wird im SELECTA nur eine Spalte angezeigt. Das
2. Zeichen in <Trennzeichen> 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 <Trennzeichen> 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 <Trennzeichen> kennzeichnet Checkboxen. Es kann
nur in den <Spaltenüberschriften> 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. Das
5. Zeichen in <Trennzeichen> kennzeichnet Comboboxen. Wenn es in
den <Spaltenüberschriften> angegeben wird, gilt es für die gesamte
Spalte. Wird ein Feld der Spalte mit SELAEDIT
editiert, so erscheint eine Combobox zur Auswahl eines Elementes. Die
Elemente der Combobox müssen hinter der Spaltenüberschrift durch das
Combobox-Trennzeichen getrennt angegeben werden. Beispiel: Das Combobox-Trennzeichen
ist §. SPALTEN_UEBERSCHRIFT$
= "Nr;§Wochentag§Montag§Mittwoch§Freitag§Sonntag;Datum;..." Die
2. Spalte hat die Überschrift "Wochentag". Wird ein Feld dieser Spalte
mit SELAEDIT editiert, so erscheint eine Combobox mit folgenden
Auswahlmöglichkeiten: Montag Mittwoch Freitag Sonntag. Es
ist auch möglich, einzelne Felder als Combobox zu editieren. Dazu darf das
Combobox-Trennzeichen nicht in der Spaltenüberschrift vorkommen. Beim
entsprechenden Spaltenelement sind die Comboboxauswahlmöglichkeiten durch das
Combobox-Trennzeichen getrennt hinter dem Feldwert anzufügen. Beispiel: Das Combobox-Trennzeichen
ist §. SPALTEN_UEBERSCHRIFT$
= "Nr;Wochentag;Datum" T$(1)
= "1;Feiertag;25.12.2011" T$(2)
= "1;Mittwoch§Montag§Mittwoch§Freitag§Sonntag;14.12.2011" Die
2. Spalte von T$(1) wird als alphanumerisches Feld editiert. Wird
die 2. Spalte von T$(2) editiert, so erscheint eine Combobox mit den Auswahlmöglichkeiten:
Montag Mittwoch Freitag Sonntag. Bei
jedem Element der Combobox kann eine individuelle Farbe angegeben werden.
Dazu müssen die Farben am Ende des Elements nach dem Text in folgendem Format
angefügt werden: #<V-Rot,V-Grün,V-Blau,H-Rot,H-Grün,H-Blau> V_Rot,
V-Grün und V-Blau legen die Vordergrundfarbe und H_Rot, H-Grün und H-Blau die
Hintergrundfarbe fest. Beispiel: Das Combobox-Trennzeichen
ist §. T$(2)
=
"1;Mittwoch§Montag§Mittwoch§Freitag§Sonntag#<255,255,255,255,0,0>;14.12.2011" Sonntag wird mit rotem Hintergrund und weißem Vordergrund
angezeigt. Achtung: Combobox-Felder müssen
bei SELAEDIT mit Feldart = A (alphanumerisch)
editiert werden. Die
Trennzeichen für rechtsbündig und zentriert können auch in den
<Spaltenüberschriften> angegeben werden. Sie gelten dann für alle
Elemente der Spalte mit Ausnahme der Elemente, bei denen ein eigenes
Trennzeichen angegeben ist. Wird
für ein Spaltenelement zusätzlich ein <Farbzeichen> angegeben, so muss
das Trennzeichen für rechtsbündige oder zentrierte Anzeige nach dem
<Farbzeichen> stehen. <Mindestzeilen>
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 <Farbzeichen> und einer <Farbe>. <Farbe>
enthält in spitzen Klammern <Vordergrundfarbe , Hintergrundfarbe>. 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 /*
rot RGB(2) = 0,0,255 /*
blau @<1,2> kennzeichnet die Farbe Rot auf Blau @<1,-1> setzt den Vordergrund auf Rot, der
Hintergrund bleibt unverändert @<-1,1> setzt den Hintergrund auf Rot, der
Vordergrund bleibt unverändert Farben
können auch in den <Spaltenüberschriften> 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
<Farbzeichen><-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
<Farbzeichen> <-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 Zeile. Ist
auch keine Zeilenfarbe festgelegt, so gilt die Farbe der Spalte. Ist
ein <Hilfetext-Trennzeichen> angegeben, so wird der Text nach dem
<Hilfetext-Trennzeichen> in den durch <Trennzeichen> getrennten
Elementen von <Array> als Hilfetext interpretiert. Dieser Text (Tooltiptext)
wird angezeigt, wenn sich die Maus über dem entsprechenden Element befindet. Ist
ein <Unsichtbar-Trennzeichen> angegeben, so wird der Text nach dem
<Unsichtbar-Trennzeichen> nicht angezeigt. Der unsichtbare Text muss
jeweils am Ende der Spaltenelemente - hinter einem eventuellen Hilfetext -
stehen. Der
ON SELECT(MOUSE) Makro 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(...) Makros können die
Variablen EBUS_SELECT_POS und EBUS_SELECTA gesetzt
werden. Nach der Ausführung des Makros 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. Achtung: Es können nicht alle Spalten
fixiert werden. Wenigstens 1 Spalte muss variabel bleiben. SELECTA
liefert folgende Ergebniswerte: -1:
Laufzeitfehler -2:
SELECTA kann im Splitwindow nur mit NOWAIT gestartet werden. -3:
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. Wenn SELECTA beendet wurde enthält die Variable
EBUS_SELECTA_SELECTED_ROWS$ durch Strichpunkt getrennt die Nummern der
markierten Zeilen. |
||||||||||||||||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||||||||||||||||
|
Beispiel: |
DIM
T$(10) /*
Farben setzen RGB(0) = 0,0,0 /* schwarz RGB(2) = 0,128,0 /* grün RGB(4) = 128,0,0 /* rot RGB(5) = 255,0,0 /* hellrot RGB(6) = 255,255,0 /* gelb RGB(15)
= 255,255,255 /* weiß WEISS_ROT$ = "\<15,4>" SCHWARZ_GELB$ = "\<0,6>" WEISS_GRUEN$ = "\<15,2>" WEISS_HELLROT$
= "\<15,5>" T$(1)
= WEISS_ROT$ + "dunkelrot;" + SCHWARZ_GELB$ + "gelb|gelber
Text;" +
WEISS_GRUEN$ + "grün in roter Spalte" T$(2)
= SCHWARZ_GELB$ + "gelb|gelber Text;" + WEISS_HELLROT$ +
"hellrot; " + WEISS_ROT$ + "rote Spalte Zeile 2" T$(3)
= WEISS_GRUEN$ + "grün;\<-1,-1>normal; " + WEISS_ROT$ + "rote Spalte Zeile
3" T$(4)
= "normal;" + WEISS_HELLROT$ + "hellrot; " + WEISS_ROT$ + "rote Spalte Zeile
4" T$(5)
= WEISS_HELLROT$ + "Diese Zeile ist hellrot;;" + WEISS_ROT$ T$(6) = "\<2,-1>Nur
der Text ist grün.;;" + WEISS_ROT$ SELECTFONT
= 0 WINDOWPOS(0,0) H%
= SELECTA(T$,"",10,"Farbe
im SELECTA", "Spalte-1;Spalte-2;"
+ WEISS_ROT$ + "@dunkelrote Spalte
rechtsbündig",
0,";@",0,"\","|") /* Wenn sich die Maus
in den Feldern "gelb" befindet, wird der /* Hilfetext
"gelber Text" angezeigt.
/* Farbe in
zeilenweiser Anzeige ohne Spalten DIM T$(10) /* Farben setzen RGB(0) = 0,0,0 /* schwarz RGB(2) = 0,128,0 /* grün RGB(4)
= 128,0,0 /* rot RGB(5)
= 255,0,0 /* hellrot RGB(6) = 255,255,0 /* gelb RGB(15) = 255,255,255
/* weiß WEISS_ROT$
= "\<15,4>" SCHWARZ_GELB$
= "\<0,6>" WEISS_GRUEN$
= "\<15,2>" WEISS_HELLROT$ = "\<15,5>" T$(1) = "Diese Zeile ist normal" T$(2) = WEISS_ROT$ + "Diese Zeile ist dunkelrot." T$(3) = SCHWARZ_GELB$ +
"Diese Zeile ist
gelb." T$(4) = WEISS_GRUEN$ + "Diese Zeile ist grün." T$(5) = WEISS_HELLROT$
+ "Diese Zeile ist
hellrot. " T$(6) = "\<2,-1>Nur der Text ist grün." WINDOWPOS(0,0) SELECTFONT
= 0 H% = SELECTA(T$,"",10,"Farbe im SELECTA","",0,"",0,"\")
|
||||||||||||||||||||||||||||||||
|
Siehe
auch: |
EBUS_SELECT_LINEWIDTH_HORIZONTAL EBUS_SELECT_LINEWIDTH_VERTICAL |