<<

Inhaltsverzeichnis

Suchen

>>

 

ADD_FIELD

 

 

Funktion

 

 

Syntax:

ADD_FIELD(<Trennzeichen>,<Attribut-String>,<Variable>[,<Makro Vorher>][,<Makro Nachher>][,<Handle>])

 

<Trennzeichen>

= <STRING-AUSDRUCK>

<Attribut-String>

= <STRING-AUSDRUCK>

<Variable>

= <VARIABLE_NS>

<Makro vorher>

= <MAKRONAME>

<Makro nachher>

= <MAKRONAME>

<Handle>

= <NUM-AUSDRUCK>

 

 

Bedeutung:

Mit der Funktion ADD_FIELD können sowohl auf bestehenden Masken als auch auf Windows, die mit der Anweisung WINDOW erzeugt wurden, zusätzliche Maskenfelder (Buttons, Checkboxen, etc.) dynamisch erzeugt werden.

 

<Handle> legt fest, in welchem Fenster das Maskenfeld erzeugt werden soll. <Handle> kann die Windowtiefe oder die Identifizierungsnummer eines Splitwindows oder eines WINDOWCALL-Windows enthalten. Fehlt der Parameter <Handle>, so wird das Maskenfeld auf der aktuellen Maske erzeugt.

 

Das erzeugte Maskenfeld wird in der Feldreihenfolge immer am Ende hinter allen bereits vorhandenen Maskenfeldern eingefügt. Die Feldreihenfolge kann mit der Funktion CHANGE_FIELDSEQUENCE geändert werden.

 

Werden Maskenfelder auf einem Window eingefügt, das mit der Anweisung WINDOW erzeugt wurde, so muss die Feldverarbeitung mit der Funktion START_FIELD gestartet werden.

 

ADD_FIELD liefert als Ergebnis 0, wenn kein Fehler auftrat, andernfalls eine der folgenden Fehlernummern:

 

Fehlernummer

Bedeutung

-1

Keine Maske gefunden

6101

Ungültiger Feldtyp

6102

Ungültige Zeilennummer

6103

Ungültige Spaltennummer

6104

Länge des Formatstrings und Länge des Dateifeldes sind verschieden

6105

Fehlerhafte Nachkommastellen

6106

Nachkommastellen des Dateifeldes stimmen nicht mit Nachkommastellen des Formatstrings überein.

6107

Doppelter Dezimalpunkt im Formatstring

6108

Nur J, Y oder N bei Vorzeichen zulässig

6109

Nur J, Y oder N bei Blinken zulässig

6111

Nur J, Y oder N bei Änderbar zulässig

6113

Nur G,K,C,L,A bei Groß-/Kleinschreibung zulässig

6114

Nur J, Y oder N bei Sonderzeichen zulässig

6115

Ungültiger Schlüssel für Blättern

6116

Nur J, Y oder N bei Automatischen Feldende zulässig

6125

ADD_FIELD ist auf der angegebenen Maske nicht zulässig

6126

Variable passt nicht zu Formatstring

6127

Formatstring ist fehlerhaft

6129

Trennzeichen fehlt

6133

Zul. Zeichen fehlt bei Radiobutton

6134

Weitere Attribute sind fehlerhaft

6135

Der Strichpunkt ist als Trennzeichen nicht zulässig

 

Parameter:

Trennzeichen

Das erste Zeichen von Trennzeichen legt das Trennzeichen fest, durch das die Einträge in <Attribut-String> getrennt werden. Der Strichpunkt ';' ist als Trennzeichen nicht zulässig, da der Strichpunkt in den weiteren Attributen als Trennzeichen verwendet wird.

 

Attribut-String

Enthält durch Trennzeichen getrennt die Attribute des Maskenfeldes. Die Attribute müssen in der nachfolgend aufgeführten Reihenfolge angegeben werden. Leere Einträge sind möglich.

 

Nummer

Attribut

Bedeutung

1

Feldtyp

F = numerisches Feld, alphanum. Feld oder Datumsfeld

E = Editfeld

B = Pushbutton

C = Checkbox

R = Radiobutton

O = Scrollbar

M = Combobox

L = Listbox

P = Defaultpushbutton

T = Statischer Text

2

Feldhöhe

Legt die Höhe des Feldes als Vielfaches der Zeilenhöhe fest. Dieses Attribut hat nur eine Bedeutung bei Feldtyp = E, B, P, C, R, O, L, T.

 

Ist Feldtyp = B, P, C oder R und wird keine Feldhöhe angegeben, so gilt die durch die Variablen EBUS_PUSHBUTTON, EBUS_CHECKBOX$ bzw. EBUS_RADIOBUTTON$ festgelegt Höhe.

 

Ist die Feldhöhe <= 0, so gilt die Standardfeldhöhe 1.5 bei Typ = B und P und sonst 1.

3

Anzahl Eingabezeichen

Dieses Attribut hat nur eine Bedeutung bei Typ = F, A, E, M.

 

Es wird die Anzahl der zulässigen Eingabezeichen festgelegt. Ist Anzahl Eingabezeichen <= 0 oder leer, so wird die Anzahl der Eingabezeichen durch den Formatstring (Attribut Nummer. 6) festgelegt.

4

Zeile

Zeilenposition des Maskenfeldes

5

Spalte

Spaltenposition des Maskenfeldes

6

Formatstring

z.B. &&&&& oder $$,$$#.##

 

Legt die Formatierung und den Typ des Maskenfeldes (numerisch, alphanumerisch, Datum) fest. Folgende Formatzeichen sind möglich:

 

& alphanumerisches Zeichen

$ numerisches Zeichen mit Nullunterdrückung

# numerisches Zeichen ohne Nullunterdrückung

^ Datumszeichen

 

Bei numerischen Feldern mit Nachkommastellen muss der Punkt '.' als Dezimalpunkt verwendet werden.

 

Bei Buttons, Checkboxen und Radiobuttons legt die Anzahl der Zeichen im Formatstring die Breite des Elements in Spalten fest.

7

Vorzeichen

Ist nur von Bedeutung bei numerischen Feldern. Folgende Werte sind möglich: J, Y, N. Der leere Eintrag ist gleichbedeutend mit N.

8

Blinken

Folgende Werte sind möglich: J, Y, N. Der leere Eintrag ist gleichbedeutend mit N.

9

Änderbar

Folgende Werte sind möglich: J, Y, N. Der leere Eintrag ist gleichbedeutend mit N.

10

Groß-/Kleinbuchstaben
/Alle

Ist nur von Bedeutung bei alphanumerischen Feldern. Folgende Werte sind möglich: G, K, C, S, A. Der leere Eintrag ist gleichbedeutend mit A.

11

Sonderzeichen zulässig

Ist nur von Bedeutung bei alphanumerischen Feldern. Folgende Werte sind möglich: J, Y, N. Der leere Eintrag ist gleichbedeutend mit J.

12

Automatisches Feldende

Folgende Werte sind möglich: J, Y, N. Der leere Eintrag ist gleichbedeutend mit N.

13

Schlüsselnummer für Blättern

Legt die Schlüsselnummer für das Blättern bei Indexdateifeldern fest.

14

Zulässige Eingabezeichen

Ist nur von Bedeutung bei alphanumerischen Feldern. Es müssen die zulässigen Eingabezeichen festgelegt werden. Bei einem leeren Eintrag sind alle Zeichen zulässig.

 

Bei Radiobuttons (Typ = R) legt das erste Zeichen von zulässige Eingabezeichen das Zeichen fest, das die Radiobuttonvariable annimmt, wenn der Radiobutton aktiviert wird.

15

Hilfetext

Legt den Text fest, der angezeigt wird, wenn sich der Mauszeiger über dem Feld befindet.

16

Weitere Attribute

Die einzelnen Attribute müssen durch den Strichpunkt ';' getrennt werden.

 

Weitere Attribute bei Feldtyp E und F:

Nr.

Inhalt

1

Rand

2

Ausrichtung: L/Z/C/R
L = links
Z = zentriert
C = zentriert
R = rechts

3

Mehrzeilig: J/Y/N

4

Nicht änderbar: J/Y/N

5

Horizontaler Scrollbalken: J/Y/N

6

Vertikaler Scrollbalken: J/Y/N

7

Passwortfeld: J/Y/N

8

Automatischer Zeilenumbruch: J/Y/N

9

Umbruch innerhalb von Wörtern: J/Y/N

10

Transparent: J/Y/N

 

Weitere Attribute bei Feldtyp B, C und R:

Nr.

Inhalt

1

Typ des Bildes: K/N/S/I
K = Kein Bild
N = Kein Bild
S = Standardbild
I = Individuelles Bild

2

Standardbildnummer (nur bei Bildtyp S)

3

Bildname, Bildname pressed, Bildname over

Nur bei Bildtyp I.

4

Bildposition: L/M/C/R
L = links
M = Mitte
C = Mitte
R = rechts

O = oben

U = unten

5

Bildgröße: O/A/T
O = Originalgröße
A = angepasst
T = total

6

Default-Pushbutton: J/Y/N (nur bei Feldtyp B)

7

Textposition: L/M/C/R
L = links
M = Mitte
C = Mitte
R = rechts

O = oben

U = unten

8

Transparent (nur bei Feldtyp B oder P)
J = Der Buttonhintergrund ist transparent.

N = Der Buttonhintergrund ist nicht transparent.

9

Ohne Rand (nur bei Feldtyp B oder P)
J = Der Button hat keinen Rand.

N = Der Button hat einen Rand.

10

Hervorheben wenn Maus über Button (nur bei Feldtyp B oder P)

J = Der Pushbutton wird hervorgehoben angezeigt, wenn sich der Mauscursor über dem Button befindet.

N = Der Pushbutton wird nicht hervorgehoben angezeigt, wenn sich der Mauscursor über dem Pushbutton befindet.

11

Nicht hervorheben wenn aktuelles Feld (nur bei Feldtyp B oder P)

J = Der Pushbutton wird nicht hervorgehoben angezeigt, wenn er das aktuelle Feld ist.

N = Der Pushbutton wird hervorgehoben angezeigt, wenn er das aktuelle Feld ist.

12

Runde Ecken (nur bei Feldtyp B oder P)

J = Der Pushbutton hat runde Ecken, Radius legt den Radius der Eckenkrümmung fest.

N = Der Pushbutton hat keine runden Ecken.

13

Radius (nur bei Feldtyp B oder P)

14

Keine runden Ecken (nur bei Feldtyp B oder P)

J = Der Pushbutton hat niemals runde Ecken, auch wenn die Variable EBUS_PUSHBUTTON_ROUNDED_CORNER entsprechend gesetzt ist.

N = Der Pushbutton hat runde Ecken wenn

EBUS_PUSHBUTTON_ROUNDED_CORNER entsprechend gesetzt ist.

 

Weitere Attribute bei Feldtyp O:

Nr.

Inhalt

1

Orientierung: H/V
H = horizontal
V = vertikal

2

Wertebereich von

3

Wertebereich bis

4

Blockgröße

 

Weitere Attribute bei Feldtyp L:

Nr.

Inhalt

1

Rand

2

Mehrfachauswahl: J/Y/N

3

Sortieren: J/Y/N

4

Horizontaler Scrollbalken: J/Y/N

5

Vertikaler Scrollbalken: J/Y/N

6

Vorbelegung: V/T
V = Variable
T = Text

7

Vorbelegung Dateiname

8

Vorbelegung Feldname

9

Vorbelegung Text

Achtung: Die einzelnen Elemente müssen durch "|" getrennt werden.

 

Weitere Attribute bei Feldtyp M:

Nr.

Inhalt

1

Rand

2

Sortieren: J/Y/N

3

Mit Editfeld: J/Y/N

4

Vorbelegung: V/T
V = Variable
T = Text

5

Vorbelegung Dateiname

6

Vorbelegung Feldname

7

Vorbelegung Text

Achtung: Die einzelnen Elemente müssen durch "|" getrennt werden.

8

Höhe des aufklappbaren Bereichs in Zeilen.

 

Weitere Attribute bei Feldtyp T:

Nr.

Inhalt

1

Rand

2

Ausrichtung: L/Z/C/R
L = links
Z = zentriert
C = zentriert
R = rechts

3

Randfarbe rot (nur bei Rand = 1)

4

Randfarbe grün (nur bei Rand = 1)

5

Randfarbe blau (nur bei Rand = 1)

6

Mehrzeilig: J/Y/N

 

17

Inhalt

Dieses Attribut hat nur eine Bedeutung bei Feldtyp C und R.

Es wird die Bezeichnung der Checkbox bzw. des Radiobuttons festgelegt.

 

18

Farbe/Schrift

Die einzelnen Attribute müssen durch den Strichpunkt ';' getrennt werden.

 

Nr.

Inhalt

1

Standardtextfarbe: J/Y/N

2

Textfarbe rot

3

Textfarbe grün

4

Textfarbe blau

5

Standardhintergrundfarbe

6

Hintergrundfarbe rot

7

Hintergrundfarbe grün

8

Hintergrundfarbe blau

9

Standardfont: J/Y/N

10

Fontname

11

Standardfonthöhe: J/Y/N

12

Fonthöhe in Zeilen

13

Fonthöhe in Punkt

14

Fett: J/Y/N

15

Kursiv: J/Y/N

 

 

Variable

Variable, die mit dem Maskenfeld verknüpft wird.

 

Wird ADD_FIELD in einer Funktion ausgeführt, so muss eine dimensionierte Variable verwendet werden, andernfalls werden lokale Variablen aus der Funktion verwendet, die nach der Beendigung der Funktion nicht mehr existieren.

 

Makro vorher

Makro vorher des Maskenfeldes

 

Makro nachher

Makro nachher des Maskenfeldes

 

Handle

Enthält die Windowtiefe oder die Identifizierungsnummer eines Splitwindows oder eines WINDOWCALL-Windows.

 

Beispiel:

/* Button erzeugen

B$ = "Button"

H$ = "B|1.5|0|10|2|&&&&&&&&&&|N|N|J|A|N|N|||Button-Hilfetext|S;4;;L;A;N;R"

 

H% = ADD_FIELD("|",H$,B$,,)

 

IF H% <> 0

THEN ... Fehler ...

ENDIF

 

Siehe auch:

DEL_FIELD

START_FIELD

MOVE_FIELD