<<

Inhaltsverzeichnis

Suchen

>>

 

SELECTA

 

 

Funktion

 

 

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

 

<Exit-Makro>

= <MAKRONAME>

<Split-Windowcall-Handle>

= <NUM-AUSDRUCK>

<Array>

= <STRING-VARIABLE>

<Voreinstellung>

= <STRING-AUSDRUCK>

<Anzahl>

= <NUM-AUSDRUCK>

<Überschrift>

= <STRING-AUSDRUCK>

<Spaltenüberschriften>

= <STRING-AUSDRUCK>

<Farbe Spaltenüberschriften>

= <NUM-AUSDRUCK>

<Bildtrennzeichen>

= <STRING-AUSDRUCK>

<Bildanzeige>

= <NUM-AUSDRUCK>

<Trennzeichen>

= <STRING-AUSDRUCK>

<Mindestzeilen>

= <NUM-AUSDRUCK>

<Farbzeichen>

= <STRING-AUSDRUCK>

<Hilfetext-Trennzeichen>

= <STRING-AUSDRUCK>

<Unsichtbar-Trennzeichen>

= <STRING-AUSDRUCK>

 

 

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:

 

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.

 

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:

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 SELECTA als Maskenfeld eingefügt werden soll.

Array

Name der Variablen eines eindimensionalen String-Arrays

Voreinstellung

Festlegung der markierten Zeilen beim Start des SELECTA

Anzahl

Anzahl der zu verwendenden Elemente von <Array>

Überschrift

Überschrift des SELECTA-Fensters

Spaltenüberschriften

Legt die Überschriften der Spalten fest.

Farbe Spaltenüberschriften

Farbe der Spaltenüberschriftzeile

Bildtrennzeichen

Kennzeichnung von Bildern

Bildanzeige

Legt fest, wie Bilder angezeigt werden.

Trennzeichen

1. Zeichen: Trennt die Felder in <Array>.

2. Zeichen: Kennzeichnet rechtsbündig.

3. Zeichen: Kennzeichnet zentriert.

4. Zeichen: Kennzeichnet Checkboxen.

Mindestzeilen

Legt fest, wie viele Zeilen im SELECTA-Fenster mindestens angezeigt werden.

Farbzeichen

Trennzeichen für Farben

Hilfetext-Trennzeichen

Trennzeichen für Hilfetext (Tooltiptext)

Unsichtbar-Trennzeichen

Der Text nach diesem Trennzeichen wird nicht angezeigt.

 

Beispiel:

/* Farbe in 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) = 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:

SELAEDIT

SET_SELAEDIT_VALUE

ENDSELAEDIT

REFRESHSELECTA

QUITSELECT

ENDSELECT

SELECT_SIZE

SELECT

SELECT_BACKGROUNDCOLOR

CLOSE_SELECT

SET_SELECTA

GET_SELECTA_SELECTED_ROWS$

WINDOWPOS

EBUS_CHILDWINDOW

EBUS_SELAEDIT_ABORT

EBUS_SELECTA

EBUS_SELECTA_COLUMNS$

EBUS_SELECT_FIELD

EBUS_SELECT_INFO

EBUS_SELECT_POS

EBUS_SELECT_COLUMN_REORDERING

EBUS_SELECT_LINEWIDTH_HORIZONTAL

EBUS_SELECT_LINEWIDTH_VERTICAL

EBUS_SELECT_TRANSPARENTMODE

EBUS_SELECT_FIXCOLUMNS

EBUS_CHILDWINDOW

EBUS_SELECTA_ROW_HEIGHT

EBUS_SELECTA_FONT_HEIGHT

EBUS_SELECTA_SELECTION

EBUS_SELECTA_SELECTED_ROWS$

EBUS_SELECTA_SORT_INFO$

EBUS_SELECTA_SORT_START

EBUS_SELECTA_SORT_END

HTML_SELECTA_INITSIZE

ENABLE / DISABLE SELECT_...