Eigenschaften von Konsolenfeldern

Allgemeine Eigenschaften

In der folgenden Tabelle sind die allgemeinen, in der Konsol-UI verfügbaren UI-Eigenschaften aufgelistet.

Tabelle 1. Allgemeine Eigenschaften für ein Konsolenfeld
Eigenschaft Beschreibung
align Gibt die Position der Daten in einem variablen Feld an, wenn die Länge der Daten kleiner ist als die Länge des Felds.
color Gibt die Farbe eines Felds in einem Konsolformular an.
dateFormat Kennzeichnet das Format der Datumsangaben.
fieldLen Gibt die Anzahl der Single-Byte-Zeichen an, die in einem Konsolformularfeld angezeigt werden können.
help Gibt den Hilfetext an, der angezeigt wird, wenn der Benutzer auf die in der Systemvariablen consoleLib.key_help angegebene Taste drückt.
highlight Gibt den Spezialeffekt (falls vorhanden) an, mit dem das Feld angezeigt werden soll.
inputRequired Gibt an, ob der Benutzer Daten im Feld eingeben muss.
intensity Gibt die Stärke der angezeigten Schriftart an.
lineWrap Gibt an, ob Text in eine neue Zeile umbrochen werden kann, so dass ein Abschneiden am Zeilenende vermieden wird.
lowerCase Gibt an, ob alphabetische Zeichen in Kleinschreibung in der Einzelbyte-Zeicheneingabe des Benutzers gesetzt werden sollen.
masked Gibt an, ob Zeichen, die der Benutzer in dieses Feld eingibt, angezeigt werden.
minimumInput Gibt die Mindestanzahl an Zeichen an, die der Benutzer in das Feld eingeben muss.
needsSOSI Gibt an, ob EGL eine besondere Prüfung ausführt, wenn der Benutzer Daten vom Typ MBCHAR auf einer ASCII-Einheit eingibt.
protect Gibt an, ob der Benutzer auf das Feld zugreifen kann.
timeFormat Gibt das Format für die Eingabe und Anzeige von Zeitangaben an.
timestampFormat Gibt das Format für die Eingabe und Anzeige von Zeitmarken an.
upperCase Gibt an, ob alphabetische Zeichen in Großschreibung in der Einzelbyte-Zeicheneingabe des Benutzers gesetzt werden sollen.
validValues Gibt die Gruppe von Werten an, die als Benutzereingabe gültig sind.
value Gibt ein Zeichenfolgeliteral an, das als Feldinhalt angezeigt wird, wenn eine Webseite angezeigt wird.

Erforderliche Eigenschaften

Die folgenden Eigenschaften sind in einer Konsolenfeldvariablen erforderlich:
  • fieldLen (sofern das Konsolenfeld ein konstantes Feld ist)
  • position

Die Eigenschaft name ist ebenfalls erforderlich, wenn auch nicht in einem konstanten Konsolenfeld.

Eigenschaften für Felder und Feldgruppen

Die folgenden Eigenschaften sind in Konsolenfeldern und Konsolenfeldgruppen von Bedeutung:

Tabelle 2. Eigenschaften für alle Felder
Eigenschaft Beschreibung
position Gibt die Zeilen- und Spaltennummer für den Anfang eines Formularfelds an. Erforderlich.
segments Gibt die Zeile, Spalte und Länge jedes Feldsegments an. Optional.

Eigenschaften nur für Feldgruppen

In der Konsol-UI gelten die folgenden Eigenschaften nur für eine Konsolenfeldgruppe. Eine solche Feldgruppe kann auch alle zuvor genannten Eigenschaften enthalten.

Tabelle 3. Eigenschaften nur für Feldgruppen
Eigenschaft Beschreibung
columns Gibt die Anzahl von Spalten an, in der die Elemente einer Konsolenfeldgruppe angegeben werden sollen. Optional.
linesBetweenRows Gibt die Anzahl von Leerzeilen zwischen den einzelnen Zeilen an, die ein Feldgruppenelement enthalten. Optional.
orientIndexAcross Gibt an, ob EGL Feldgruppenelemente horizontal (statt vertikal) in der Anzeige verteilen soll. Optional.
spacesBetweenColumns Gibt die Anzahl von Leerzeichen an, die die einzelnen Spalten von Feldgruppenmitgliedern trennen. Optional.

Eigenschaften nur für Felder

In der Konsol-UI gelten die folgenden Eigenschaften nur für ein Feld:

Tabelle 4. Eigenschaften nur für Felder
Eigenschaft Beschreibung
autonext Gibt an, ob der Cursor in das nächste Feld springt, nachdem der Benutzer das aktuelle Konsolenfeld ausgefüllt hat. Optional.
binding Gibt den Namen der Variablen an, an die das Konsolenfeld standardmäßig gebunden ist. Optional.
caseFormat Gibt an, ob bei Eingaben und Ausgaben die Groß-/Kleinschreibung beachtet werden muss. Optional.
comment Gibt den in der fensterspezifischen Kommentarzeile angezeigten Text an. Optional.
commentKey Gibt eine Taste an, über die das Ressourcenpaket nach Kommentaren durchsucht werden kann, die in der fensterspezifischen Kommentarzeile angezeigt werden. Optional.
dataType Gibt eine Zeichenfolge an, die einen Datentyp für das Feld kennzeichnet. Optional.
editor Gibt das Programm an, in dem Benutzer LOB-Daten bearbeiten können. Optional.
initialValue Gibt den ursprünglich angezeigten Wert für das Feld an. Optional.
initialValueKey Gibt eine Zugriffstaste für die Suche nach dem Ressourcenpaket an, in dem der Anfangswert enthalten ist, der angezeigt werden soll. Optional.
name Gibt eine ID für Variablen an, die ansonsten nicht benannt sind. Optional.
numericFormat Gibt an, wie die numerische Ausgabe formatiert werden soll. Optional.
pattern Gibt das Muster für die Eingabe- und Ausgabeformatierung an, wenn der Inhalt des Felds vom Typ Text ist. Optional.
sqlColumnName Gibt den Namen der Datenbanktabellenspalte an, die dem Feld zugeordnet ist. Optional.
verify Gibt an, ob der Benutzer aufgefordert wird, denselben Wert erneut einzugeben, nachdem er versucht hat, das Feld zu verlassen. Optional.

Feedback