SELECT
|
Syntax: |
SELECT([<WAIT|NOWAIT>,<Exit-Makro>,<Split-Windowcall-Handle>], <Indexdateiname>,
<Schlüsselnummer>, <Gleich>, <Überschrift>
,<Spaltenüberschriften>, <Farbe Spaltenüberschriften>,
<Einzelfarben Spaltenüberschriften> [,@<Bildtrennzeichen>,<Bildanzeige>] [,#<Markierfeld>,<Markierfarbe>], <Felder>) <Felder>
= ~<Felderstring> | <Selectfeld>, <Feldbreite> [,<Selectfeld>,<Feldbreite>]…
|
||||||||||||||||||||||||||||||||||
|
|
|
||||||||||||||||||||||||||||||||||
|
Bedeutung: |
SELECT
öffnet ein Fenster, in dem die Datensätze einer Indexdatei angezeigt werden. WINDOWPOS legt die Position des SELECT-Windows
fest. Achtung: Anstelle von
<INDEXDATEI-NAME> kann bei dieser Funktion nicht wie bei anderen Indexdatei-Anweisungen
ein <STRING-AUSDRUCK> angegeben werden. SELECT
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 SELECT wie die anderen Felder der Maske mit den Tasten <→|>, <↓>, etc. angesprungen
werden. Im <Exit-Makro> enthält die Variable EBUS_DATA den Returncode des SELECT. Bei
NOWAIT wird der SELECT gestartet und die Funktion kehrt sofort zurück und
liefert die Identifizierungsnummer (Handle) des SELECT. Mit der Anweisung CLOSE_SELECT(<Handle>) kann ein mit
NOWAIT geöffneter SELECT geschlossen werden. Bei
WAIT wird SELECT hierarchisch gestartet: Die Funktion kehrt erst zurück, wenn
der SELECT beendet wurde. Der
Makro <Exit-Makro> wird ausgeführt, nachdem der SELECT 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 SELECT. Wenn
der SELECT im Splitwindow angezeigt werden soll, muss NOWAIT gesetzt sein und
<Split-Windowcall-Handle> muss die Identifizierungsnummer des
Splitwindows enthalten. Wenn
der SELECT 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
Schalter und ON <EREIGNIS> Makros werden bei
NOWAIT beim Start des SELECT und bei jedem Verlassen des SELECT gesichert.
Beim erneuten Aktivieren des SELECT wird der letzte Zustand der Schalter und
ON <Ereignis> Makros wieder hergestellt. Nach jedem ON SELECT(<Taste>) MACRO, der im SELECT
ausgeführt wird, werden die ON <Ereignis> Makros erneut gesichert. Es
können optional <Spaltenüberschriften> definiert werden. Diese erscheinen
dann in der 1. Zeile des SELECT-Fensters mit der
<Farbe-Spaltenüberschriften>. Ist das erste Zeichen der
<Spaltenüberschriften> der Strichpunkt ';', so wird davon ausgegangen,
dass <Spaltenüberschriften> durch Strichpunkt getrennt die Überschriften
der Spalten enthält. In
<Einzelfarben Spaltenüberschriften> kann durch Strichpunkte getrennt
für jede Spaltenüberschrift eine eigene Farbe angegeben werden. Für jede
Farbe muss in eckigen Klammern <Vordergrundfarbe , Hintergrundfarbe>
angegeben werden. 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. Es
können Checkboxen im SELECT angezeigt werden. Im SELECTA werden
Checkboxen durch ein Trennzeichen festgelegt. Beim SELECT sind keine
Trennzeichen vorgesehen. Hier wird das Trennzeichen für Checkboxen durch die
Variable EBUS_SELECT_CHECKBOXCHAR$ festgelegt. Das Trennzeichen muss in der Spaltenüberschrift
als erstes Zeichen angegeben werden. Dadurch werden alle Felder der Spalte
als Checkbox angezeigt. Es ist nicht möglich, einzelne Felder einer Spalte
als Checkbox zu kennzeichnen. Das
Zeichen EBUS_SELECT_COMBOBOXCHAR$
kennzeichnet Comboboxen. Es kann nur in den
<Spaltenüberschriften> angegeben werden und gilt für die gesamte
Spalte. Wird ein Feld der Spalte mit SELEDIT$
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 SELEDIT$ editiert, so erscheint
eine Combobox mit folgenden Auswahlmöglichkeiten: Montag Mittwoch Freitag
Sonntag. Achtung: EBUS_SELECT_COMBOBOXCHAR$ darf
nur bei alphanumerischen Feldern angegeben werden. Wird
die Überschriftszeile mit der Maus angegeklickt, so wird der ON MOUSE Makro ausgeführt. Sind die Feldüberschriften durch ';' getrennt, dann
enthält EBUS_SELECT_FIELD die Nummer
der angeklickten Spalte, andernfalls ist EBUS_SELECT_FIELD = 0. Im
SELECT 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:
Wahlweise
kann ein Feld der Indexdatei als <Markierfeld> definiert werden. Dazu muss zur
Kennzeichnung das Zeichen '#' vor dem Feldnamen stehen. Das Feld muss ein alphanumerisches
Feld sein. Numerische und Datumsfelder sind nicht zulässig. Das Markierfeld
erscheint nicht in der Anzeige. Ist dies gewünscht, so muss der Feldname
nachfolgend noch einmal als <Selectfeld> angegeben werden. Wenn ein
Markierfeld angegeben wird, wird bei der Anzeige der Datensätze bei jedem
Datensatz geprüft, ob das Markierfeld nur aus Leerzeichen (Blanks) besteht.
Ist dies der Fall, wird die Zeile als nicht markiert betrachtet und in normal
angezeigt. Enthält das Feld irgendein anderes Zeichen außer Leerzeichen, so
wird die Zeile in der <Markierfarbe> angezeigt. Als Markierfarbe ist
eine RGB-Farbe anzugeben. Neben
den Indexdateivariablen können als <Selectfeld> auch konstante Strings,
alphanumerische Hilfsvariable und alphanumerische Indexdateivariable aus
anderen Indexdateien angezeigt werden. Zur Unterscheidung von den Feldern der
im SELECT angegebenen Indexdatei muss diesen Variablen das Zeichen '$'
vorangestellt werden. Dies gilt nicht für konstante Strings, da diese durch
das Zeichen " eindeutig definiert sind. In konstanten Strings dürfen die
Zeichen ', ' und '; ' nicht vorkommen. Es können nur alphanumerische
Variablen (keine numerischen oder Datumsvariablen) angegeben werden. Hilfsvariable
und Variablen anderer Indexdateien können genauso wie die Variablen der
Indexdatei im ON SELECT Makro beliebig
manipuliert werden können. Für
jedes einzelne Feld kann im ON SELECT Makro mit Hilfe
der Variablen EBUS_SELECT_COLOR$ eine eigene
Farbe definiert werden. SELECT
kann mit beliebig vielen Argumenten aufgerufen werden. Bei jedem Feldnamen
kann die anzuzeigende <Feldbreite> festgelegt werden. Die
<Feldbreite> muss nicht angegeben werden. Fehlt sie, so wird das Feld
in der bei der Dateibeschreibung definierten Länge angezeigt. Bei der Angabe
der Feldnamen ist auch die Angabe des Dateinamens vor dem Feldnamen zulässig.
Ist <Feldbreite> = n, so werden bei alphanumerischen und Datumsfeldern
die linken n Zeichen und bei numerischen Feldern die rechten n Ziffern
angezeigt. Anstelle
der Argumente <Selectfeld>, <Feldbreite> [,<Selectfeld>,<Feldbreite>]… kann auch ein Stringausdruck ~<Felderstring>
angegeben werden. <Felderstring> enthält die anzuzeigenden Felder
wieder im Format <Selectfeld>, <Feldbreite> [,<Selectfeld>,<Feldbreite>]… . Nach
dem Aufruf der Funktion SELECT wird zuerst ein START
bzw. ein STARTS in der Indexdatei mit Schlüssel
= <Schlüsselnummer> ausgeführt. Liefert der START-Befehl einen Fehler,
so wird die Funktion SELECT mit Return-Code -1 verlassen. Über READ-NEXT bzw. READS-NEXT
werden so viele Datensätze gelesen bis das Fenster voll ist. Ist <Gleich>
größer als 0, so wird der Inhalt der Schlüsselfelder des Schlüssels
<Schlüsselnummer> vor der Ausführung der START-Anweisung gesichert.
Nach jedem erfolgreichen Lesezugriff (READ-NEXT bzw. READS-NEXT) wird
geprüft, ob die linken <Gleich> Zeichen des Schlüssels des gerade
gelesenen Satzes mit den Zeichen des gesicherten Schlüssels übereinstimmen.
Ist dies nicht der Fall, so wird der
letzte Dateizugriff wie das Dateiende behandelt. Bei
ENABLE SELECT_ASCENDING werden die Datensätze aufsteigend, bei DISABLE SELECT_ASCENDING absteigend angezeigt. Bei
ENABLE SELECT_SEARCH wird bei der Eingabe von Anfangsbuchstaben
(alphanumerisches Schlüsselfeld) bzw. Endziffern (numerisches Schlüsselfeld)
der Inversbalken automatisch auf den Datensatz positioniert, dessen Schlüssel
mit den eingegebenen Zeichen beginnt bzw. endet. Existiert kein derartiger
Datensatz, so wird der Inversbalken auf den Datensatz mit dem nächstgrößeren
Schlüssel positioniert. Der ON SELECT(PGDN) Makro wird
ausgeführt und die eingegebenen Zeichen werden in der Meldungszeile
angezeigt. Ist Parameter <Gleich> > 0, so beziehen sich die zur
Suche eingegebenen Zeichen auf die Position <Gleich> + 1, d.h. der
Suchstring setzt sich zusammen aus den ersten <Gleich> Zeichen des
Selectschlüssels und den eingegebenen Zeichen. Der Schalter hat keine
Wirkung, wenn ein ON SELECT(KEY) Makro aktiv ist. Der
ON SELECT(MOUSE) Makro wird im
SELECT ausgeführt, wenn die linke Maustaste betätigt wurde und gleichzeitig
eine oder mehrere der Tasten SHIFT, Alt oder Strg gedrückt sind. Mit den
Tasten <↓>, <↑>, <PGDN> und <PGUP> kann beliebig
vorwärts und rückwärts geblättert werden (in der Sortierreihenfolge des
angegebenen Schlüssels). Ist <Gleich> = 0, so kann in der ganzen Datei
geblättert werden, andernfalls nur in dem durch <Gleich> sich
ergebenden Ausschnitt der Datei. Mit
<RETURN> kann ein Datensatz ausgewählt werden. In diesem Fall wird der
ausgewählte Satz über den Primärkey gelesen (und ist damit der aktuelle Satz
in der Indexdatei) und die Funktion SELECT wird mit Return-Code = 1
verlassen. Dasselbe gilt bei der Auswahl eines Datensatzes mit der linken
Maustaste. Bei DISABLE SELECT_DOUBLECLICK kann
ein Datensatz durch einen einfachen Mausklick mit der linken Maustaste
ausgewählt werden, bei ENABLE SELECT_DOUBLECLICK
ist ein Doppelklick notwendig oder ein einfacher Mausklick auf die aktuell
markierte Zeile. Mit <Esc> wird SELECT mit Return-Code 0
beendet. Wird
SELECT mit Returncode 0 beendet (kein Datensatz wurde ausgewählt), so wird
nach dem Verlassen der Funktion SELECT der Datensatz wieder über den
Primärkey gelesen, der vor dem Aufruf des SELECT gültig war. Innerhalb
der Funktion SELECT wird temporär auf NOREADLOCK
umgeschaltet. Dadurch können im Multi-User-Betrieb auch gesperrte Datensätze
gelesen und angezeigt werden. Wenn das Betriebssystem oder Netzwerk das Lesen
gesperrter Datensätze nicht zulässt, so wird anstelle der Daten eine Zeile
mit Fragezeichen '?' angezeigt. Die
Variable EBUS_SELECT_FIXCOLUMNS
legt fest, welche Spalten des SELECT fixiert werden. Fixierte Spalten bleiben
immer sichtbar, auch wenn der horizontale Scrollbalken des SELECT nach rechts
verschoben wird. Achtung: Es können nicht alle Spalten fixiert werden.
Wenigstens 1 Spalte muss variabel bleiben. SELECT
liefert folgende Ergebniswerte: -1:
Keine Datensätze gefunden -2:
SELECT kann im Splitwindow nur mit NOWAIT gestartet werden. 1:
Der Benutzer hat einen Datensatz mit <RETURN> ausgewählt. 0:
Der Benutzer hat keinen Datensatz ausgewählt, der SELECT wurde mit <Esc> verlassen. |
||||||||||||||||||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||||||||||||||||||
|
Beispiel: |
Beispiel 1: Die Indexdatei wird in der
Sortierreihenfolge des Sekundärkey 2 (PLZ) gelesen. Es werden die linken 10
Zeichen von NAME$, die rechten 4 Ziffern von NR, PLZ ganz und die linken 10
Zeichen von ORT$ angezeigt. Es kann in der gesamten Datei geblättert werden. WINDOWPOS(0,0) KUNDEN.PLZ = 0 RGB(2) = 0,128,0 H% = SELECT(KUNDEN,2,0,"Kunden-Übersicht",";Name;Nr;PLZ;Ort",2,"",
NAME$,10,NR,4,PLZ,,ORT$,10) CASE H% OF
-1 ... /* keine Datensätze gefunden OF
1 ... /* Datensatz wurde ausgewählt OF
0 ... /* kein Datensatz wurde ausgewählt ENDCASE Beispiel 2: Es sollen im SELECT mit
der Taste <RETURN> beliebig viele Kunden-Datensätze markiert werden
können. Nach Beendigung des SELECT mit F10 sollen die markierten Datensätze
weiter bearbeitet werden. Dazu wird in der Datei KUNDEN ein einstelliges Feld
KZ$ definiert. Dieses Feld ist normalerweise immer leer. Im SELECT wird
dieses Feld als Markierfeld definiert. Wird das Feld markiert, wird dort ein
Stern eingetragen. In der Dateibeschreibung wird ein eigener Sekundärkey für
das Feld KZ$ festgelegt. Über diesen Sekundärkey können nach dem SELECT die
markierten Datensätze gefunden und verarbeitet werden. ON SELECT(RETURN)
MACRO MARKIEREN ON SELECT(F10) MACRO
VERARBEITUNGS.KZ.SETZEN F10_KZ% = 0 KUNDEN.NR = 0 /* Primärkey. Start am Dateianfang WINDOWPOS(0,0) RGB(2) = 0,128,0 FELDER$ = "NR,,NAME$,,PLZ,,ORT$" H% = SELECT(KUNDEN,0,0,"Kunden",";Name;Nr;PLZ;Ort",2,"",
#KZ$,2,$FELDER$) ON SELECT(RETURN)
RESET ON SELECT(F10)
RESET IF F10_KZ% = 1 /* F10
wurde gedrückt, also markierte Daten verarbeiten THEN N1: KUNDEN.KZ$ = "*" STARTS(2) KUNDEN /* Sekundärkey-2 besteht nur
aus KUNDEN.KZ$
ON ERROR GOTO
ENDE END ... /* Verarbeitung des Datensatzes KUNDEN.KZ$ = " " /* Markierung
zurücksetzen WRITE KUNDEN ON
ERROR ... END GOTO
N1 /* Nächsten markierten
Datensatz suchen ENDIF ENDE: ... Makro
MARKIEREN: READSELECT ON ERROR
... END /* Aktuellen Datensatz lesen IF KUNDEN.KZ$ =
"*" /* Satz ist bereits
markiert THEN KUNDEN.KZ$ = "
" /* Markierung
zurücksetzen ELSE KUNDEN.KZ$ =
"*" /* markieren ENDIF WRITE KUNDEN ON ERROR ... END /*
Datensatz zurückschreiben UNGETCHAR
CURSDN$ /* auf den nächsten Datensatz positionieren Macro VERARBEITUNGS.KZ.SETZENF10_KZ% = 1 QUITSELECT /* SELECT beenden Beispiel
3: Anzeigen Felder aus einer anderen Indexdatei ON SELECT MACRO
HOLE.ORT H% = SELECT(KUNDEN,0,0,"Kunden","",0,"",NR,,PLZ,,$ORTE.ORTSNAME$) Makro HOLE.ORTORTE.PLZ = KUNDEN.PLZ READ ORTE ON ERROR
ORTE.ORTSNAME$ = "" END Beispiel
4: Anzeigen Hilfsvariable ON SELECT MACRO HOLE.ORT H% = SELECT(KUNDEN,0,0,"Kunden","",0,"",NR,,PLZ,,$H_ORT$) Makro HOLE.ORTORTE.PLZ = KUNDEN.PLZ READ ORTE ON ERROR
ORTE.ORTSNAME$ = "" END H_ORT$ = NOBLANK$(1,ORTE.ORTSNAME$) |
||||||||||||||||||||||||||||||||||
|
Siehe
auch: |
EBUS_SELECT_LINEWIDTH_HORIZONTAL EBUS_SELECT_LINEWIDTH_VERTICAL |