Dialogobjekt Eingabefeld
Dialogobjekt Eingabefeld
Mit dem Dialogobjekt Eingabefeld werden sowohl Eingabewerte abgefragt als auch einfach nur angezeigt (Eigenschaft „veränderbar" abgeschaltet). Dies ist durch die Hintergrundfarbe des Feldes (weiß = veränderbar; grau = reine Anzeige) sofort erkennbar.
Eine Ausgabe von „berechneten Fixtexten" ist ebenfalls möglich, um z.B. eine Angebotsnummer in einer Überschrift darzustellen: "Angebot 4711: Kalkulation". Dazu ist die Eigenschaft „Veränderbar" auszuschalten und bei der Eigenschaft „Darstellung" „ohne Rahmen" zu wählen. Das Eingabefeld sieht dann optisch wie ein Fixtext aus.
Die Formatierung des Wertes erfolgt im Standardfall über das für den Parameter in der Parametertabelle eingestellte Format, das wie in Microsoft Access auch die jeweilige Einheit enthalten darf. Um diese Formatierung zu nutzen, müssen die Eigenschaften Eingabelänge und Nachkommastellen (s.u.) die voreingestellten Standardwerte behalten. Änderungen dieser Einstellungen sollten nur in Sonderfällen gemacht werden.
Ein Eingabefeld besitzt neben den allgemeinen Eigenschaften Allgemeine Eigenschaften der Dialogelemente folgende Eigenschaften:
Initialisierung | Darstellung eines Standardwertes im Dialog. Dieser Wert wird nur Entwicklungssystem verwendet, um leichter die benötigte Breite des Eingabefelds ermitteln zu können. Im Laufzeitsystem wird dieser Wert nur verwendet, wenn das Eingabefeld keinen Parameter zugeordnet bekommt, oder als Defaultwert, wenn bei der Verwendung eines regulären Ausdrucks die Eingabe verworfen wird. |
Datentyp | Datentyp des Parameters. Bei Verwendung des Eingabeassistenten zur Parameterauswahl wird dieses Feld automatisch übernommen. Wenn als Datentyp „Datum" gewählt wird, so wird automatisch statt eines Eingabefelds ein Datumsauswahlfeld verwendet, mit dem das Datum ausgewählt werden kann. |
Überprüfung | Durch Anschalten der Überprüfung kann während der Ausführung dieses Dialoges direkt auf Wertänderungen bei Verlassen dieses Feldes reagiert werden. Dies kann zur Fehlerprüfung der Benutzereingaben wie auch zum Setzen von Vorschlagswerten für andere Dialogfelder genutzt werden. Wahlweise kann die Überprüfung nur bei geänderten Werten oder auch generell beim Verlassen des Feldes aktiviert werden. |
Eingabelänge | Anzahl der Stellen, die als Eingabe zulässig sind. In der Regel sollte diese Einstellung auf dem Standardwert 0 bleiben, der eine nicht beschränkte Eingabe bedeutet. Dies gilt insbesondere für Zahl-Eingaben. Eine Ausnahme stellen alphanumerische Datenbank-Felder dar, die in der Datenbankdefinition beschränkt sind. Hier sollte die Eingabelänge auf diesen Wert gesetzt werden, um einen korrekten Datentransfer sicherzustellen. |
Nachkommast. | Anzahl der darzustellenden Nachkommastellen für Parameter vom Datentyp Dezimal. Die Standardeinstellung (-1) setzt den System-Standard (6 Stellen), wenn kein Format in der Parametertabelle angegeben wurde (siehe oben unter „Formatierung"). Als Trennzeichen wird das über die Windows-Systemeinstellung eingestellte Trennzeichen verwendet. |
Attribut | Für eine Verwendung des Dialogs im WEB kann hier der Name der Kontroll-ET eingetragen werden, die beim Ändern des Werts aufgerufen wird. |
Veränderbar | Hier kann festgelegt werden, ob in dem jeweiligen Feld zur Laufzeit Werte eingegeben werden können oder nicht. Dies ist eine Voreinstellung, die zur Laufzeit mit der Funktion f$SetzeBoolProp geändert werden kann. |
Mehrzeilig | Nach Aktivieren dieser Eigenschaft kann das Eingabefeld auch in der Höhe verändert werden. Ist ein Text bei der Ausführung dann länger als 1 Zeile, wird Wortweise umgebrochen. |
Orientierung | Standard: Zeichenketten werden links-, Zahlen rechtsbündig dargestellt |
Darstellung | Standard: Das Feld wird entweder in 3D-Darstellung oder Flach dargestellt (abhängig von der Einstellung „3D-Darstellung" im Dialogobjekt Dialogfenster) |
Hintergrundfarbe | Eingabefelder, die veränderbar und kein Datumsauswahlfeld sind, können eine Hintergrundfarbe erhalten. |
Regulärer Ausdruck | Zuweisen eines regulären Ausdrucks, der die erlaubte Eingabe begrenzt. Falls die Eingabe die Kriterien des Ausdrucks verletzt, wird der Text der Initialisierung verwendet. |
Dem Eingabefeld muss unbedingt ein Parameter zugeordnet werden. Ansonsten erscheint beim Speichern des Dialogs eine Fehlermeldung.
Beispiel der regulären Ausdrücke
Zeichenklasse | Beschreibung | Muster | Bedeutung |
[Zeichengruppe] | Entspricht einem beliebigen einzelnen Zeichen in der Zeichengruppe. | [abc] | Ein einzelnes Zeichen a oder b oder c |
[ˆZeichengruppe] | Entspricht jedem beliebigen einzelnen Zeichen, das nicht in der Zeichengruppeist. | [ˆabc] | Ein einzelnes Zeichen aussr a oder b oder c |
[Anfang-Ende] | Zeichenbereich: Entspricht jedem beliebigen einzelnen Zeichen im Bereich von Anfang bis Ende. | [0-9] | Eine einzelne Ziffer 0 bis 9 |
\ | Entspricht einer beliebigen Dezimalziffer. | \d | Eine einzelne Ziffer 0 bis 9 |
\ | Entspricht einem beliebigen Zeichen, das keine Dezimalziffer ist. | \D | |
* | Entspricht dem vorangehenden Element nicht oder mehrmals. | \ | Zahl mit . und 2 Nachkommastellen |
+ | Entspricht dem vorangehenden Element einmal oder mehrmals. | [A-Z][a-z]+ | Wort mit einem Grossbuchstaben und mindestens 1 Kleinbuchstaben |
{ n } | Entspricht dem vorangehenden Element genau n -mal. | \ | Genau 5 Ziffern |
{ n | Entspricht dem vorangehenden Element mindestens n -, höchstens jedoch m -mal. | \ | 3 bis 5 Ziffern |
{ n | Entspricht dem vorangehenden Element mindestens n -mal. | \ | Zahl mit mindestens 2 Ziffern |
Weitere Informationen: https://docs.microsoft.com/de-de/dotnet/standard/base-types/regular-expression-language-quick-reference