<<

Contents

Search

>>

 

SELECTA

 

 

Function

 

 

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

 

<Exit Macro>

= <MACRONAME>

<Split Handle>

= <NUM-EXPRESSION>

<Array>

= <STRING-VARIABLE>

<Default Value>

= <STRING-EXPRESSION>

<Count>

= <NUM-EXPRESSION>

<Header>

= <STRING-EXPRESSION>

<Column Headers>

= <STRING-EXPRESSION>

<Color Column Headers>

= <NUM-EXPRESSION>

<Image Separator>

= <STRING-EXPRESSION>

<Image Display>

= <NUM-EXPRESSION>

<Separator>

= <STRING-EXPRESSION>

<Minimum Rows>

= <NUM-EXPRESSION>

<Color Separator>

= <STRING-EXPRESSION>

 

 

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:

 

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.

 

<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:

WAIT|NOWAIT

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

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

Exit Macro

Name of Exit Macro

Split Handle

Handle of the split windows in which the SELECT shall be displayed.

Array

Name der Variablen eines eindimensionalen String-Arrays

Default Value

Festlegung der markierten Zeilen beim Start des SELECTA

Count

Number of elements in <Array> which shall be used.

Header

Window title

Column Headers

Headers of  the columns

Color Column Headers

Color of the column header line

Image Separator

Identification of images

Image Display

Specifies the display mode of images

Separator

1. Character: Separates the fields in <Array>.

2. Character: Specifies right justified.

3. Character: Specifies centered.

4. Character: Specifies Checkboxes.

Minimum Rows

Specifies the minimum number of rows in the SELECTA window.

Color Separator

Separator for colors

 

Sample:

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

SELAEDIT

REFRESHSELECTA

QUITSELECT

ENDSELECT

SELECT

SELECT_BACKGROUNDCOLOR

CLOSE_SELECT

SET_SELECTA

WINDOWPOS

EBUS_SELECTA

EBUS_SELECTA_COLUMNS$

EBUS_SELECT_POS

EBUS_SELECT_TRANSPARENTMODE

EBUS_SELECT_FIXCOLUMNS

EBUS_CHILDWINDOW

EBUS_SELECTA_SELECTION

EBUS_SELECTA_ROW_HEIGHT

EBUS_SELECTA_FONT_HEIGHT