<<

Inhaltsverzeichnis

Suchen

>>

 

SELECT

 

 

Funktion

 

 

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>]…

 

<Exit-Makro>

= <MAKRONAME>

<Split-Windowcall-Handle>

= <NUM-AUSDRUCK>

<Indexdateiname>

= <INDEXDATEI-NAME>

<Schlüsselnummer>

= <ZAHL>

<Gleich>

= <NUM-AUSDRUCK>

<Überschrift>

= <STRING-AUSDRUCK>

<Spaltenüberschriften>

= <STRING-AUSDRUCK>

<Farbe Spaltenüberschriften>

= <NUM-AUSDRUCK>

<Einzelfarben Spaltenüberschriften>

= <STRING-AUSDRUCK>

<Bildtrennzeichen>

= <STRING-AUSDRUCK>

<Bildanzeige>

= <NUM-AUSDRUCK>

<Markierfeld>

= <INDEXDATEI-FELD>

<Markierfarbe>

= <NUM-AUSDRUCK>

<Selectfeld>

= <INDEXDATEI-FELD>

<Feldbreite>

= <NUM-AUSDRUCK>

<Felderstring>

= <STRING-AUSDRUCK>

 

 

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:

 

1

Die Bilder werden proportionalitätsgetreu auf den zur Verfügung stehenden Platz (Zeilenhöhe) vergrößert bzw. verkleinert und linksbündig angezeigt.

2

Die Bilder werden proportionalitätsgetreu auf den zur Verfügung stehenden Platz (Zeilenhöhe) vergrößert bzw. verkleinert und in der Feldmitte angezeigt.

3

Die Bilder werden in der Originalgröße angezeigt. Ist ein Bild zu groß oder zu breit, so wird das Bild proportionalitätsgetreu verkleinert. Die Anzeige erfolgt linksbündig.

sonst

Die Bilder werden in der Originalgröße angezeigt. Ist ein Bild zu groß oder zu breit, so wird das Bild proportionalitätsgetreu verkleinert. Die Anzeige erfolgt in der Feldmitte.

 

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:

WAIT|NOWAIT

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

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

Exit-Makro

Name des Exit-Makros

Split-Windowcall-Handle

Identifizierungsnummer eines Splitwindows, in dem der SELECT angezeigt werden soll oder Identifizierungsnummer einer WINDOWCALL-Maske, auf der der SELECT als Maskenfeld eingefügt werden soll.

Indexdateiname

Name der Indexdatei

Schlüsselnummer

Nummer des Schlüssels der Indexdatei: 0 = Primärkey, 1,... = Sekundärkey

Gleich

Anzahl der Zeichen des Schlüssels, die übereinstimmen müssen.

Überschrift

Überschrift des SELECT-Fensters

Spaltenüberschriften

Spaltenüberschriften durch Strichpunkt getrennt

Farbe Spaltenüberschriften

Farbe der Spaltenüberschriftzeile

Einzelfarben Spaltenüberschriften

Farben der einzelnen Spaltenüberschriften

Bildtrennzeichen

Kennzeichnung von Bildern

Bildanzeige

Legt fest, wie Bilder angezeigt werden.

Markierfeld

Name eines Indexdateifeldes

Markierfarbe

RGB-Farbe

Selectfeld

Feld der Indexdatei des SELECT oder Feld einer anderen Indexdatei oder $<STRING-VARIABLE>

Feldbreite

Anzeigebreite von <Selectfeld> in Spalten

Felderstring

Enthält die anzuzeigenden Felder im Format <Selectfeld>, <Feldbreite> [,<Selectfeld>,<Feldbreite>]…

 

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.SETZEN

F10_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.ORT

ORTE.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.ORT

ORTE.PLZ = KUNDEN.PLZ

READ ORTE ON ERROR ORTE.ORTSNAME$ = "" END

H_ORT$ = NOBLANK$(1,ORTE.ORTSNAME$)

 

Siehe auch:

SELEDIT$

SET_SELAEDIT_VALUE

SELECT_SIZE

SELECTA

ENDSELECT

QUITSELECT

READSELECT

REFRESHSELECT

STARTSELECT

RESTARTSELECT

CLOSE_SELECT

SET_SELECTA

SELECT_BACKGROUNDCOLOR

WINDOWPOS

EBUS_CHILDWINDOW

EBUS_SELECT

EBUS_SELECT_BUTTONS

EBUS_SELECT_COLOR$

EBUS_SELECT_CHECKBOXCHAR$

EBUS_SELECT_COMBOBOXCHAR$

EBUS_SELECT_FIELD

EBUS_SELECT_FIXCOLUMNS

EBUS_SELECT_INFO

EBUS_SELECT_KEY

EBUS_SELECT_POS

EBUS_SELECT_ZERO

EBUS_SELECT_COLUMN_REORDERING

EBUS_SELECT_LINEWIDTH_HORIZONTAL

EBUS_SELECT_LINEWIDTH_VERTICAL

EBUS_SELECT_TRANSPARENTMODE

EBUS_SELECTA_ROW_HEIGHT

EBUS_SELECTA_FONT_HEIGHT

ENABLE / DISABLE SELECT_...