¶ Beschreibung
TextBox = Textfeld
Eine TextBox verwenden Sie im Formular, wenn Sie Eingaben erwarten. Folgende Eigenschaften stellt der MASKITO FormDesigner für TextBoxen zur Verfügung.
TextBoxen werden im PDF-Ausdruck ausgegeben.
¶ Eigenschaften
| Eigenschaft | Erklärung |
|---|---|
| AnzeigeFormat | Darstellung von Zahlen in der TextBox (Währung, Prozentsatz, etc.) Hinweis: Bei Anzeigeformat Prozent werden Eingaben zwischen 0 und 1 erwartet, z. B. wird die Eingabe “0,5” als “50%” ausgegeben.Standard: Text |
| TextAlign | Ausrichtung des Textes Auswahl mit Hilfe eines Assistenten |
| AutoSize | Automatische Anpassung der Höhe der TextBox mit Eingabe des Textes (Eigenschaft: MultiLine muss aktiviert sein) Angabe: True (Ja) oder False (Nein) |
| MaxLength | Maximale Anzahl von Zeichen (max. 32767) |
| MaxHeight | Maximale Anzahl an Zeilen (Angabe in Pixel) |
| MinLines | Maximale Anzahl an Zeilen bei automatischer Zeilenanpassung |
| MultiLine | Textfeld darf mehrere Zeilen Text enthalten Angabe: True (Ja) oder False (Nein) |
| ReadOnly (bis Formularware 3.0 SP I = OnlyRead) | Textfeld darf nur gelesen werden, Änderungen sind nicht möglich Angabe: True (Ja) oder False (Nein) |
| UseOverflow | Textüberlauf verwenden, der Inhalt der Textbox kann in eine andere Textbox weiterfließen, wenn er zu lang ist. Angabe: True (Ja) oder False (Nein) |
| Ist Pflichtfeld | Markiert das Eingabefeld als Pflichtfeld, so dass ein Wert eingegeben werden muss. Das Feld enthält dann einen Indikator. Angabe: True (Ja) oder False (Nein) |
| Rechtschreibprüfung | Rechtschreibprüfung de-/aktivieren False = Rechtschreibprüfung inaktiv True = Rechtschreibprüfung aktiv |
| WatermarkedColor | Farbe für den Hilfstext (siehe auch WaterMarkedText) |
| WaterMarkedText | Hilfstext für das Eingabefeld, der eingeblendet wird, wenn die TextBox leer ist. |
| Validierung | Eingabeprüfung für verschiedene Formate z.B. E-Mail, Datum, … |
Für Windows-Formulare können Sie für konkrete Controls über den Befehl xmloutput in Funktionen flexibel zur Laufzeit steuern, ob die betreffenden Nutzereingaben bei der Speicherung des Datensatzes als sfx-Datei (XML) ausgegeben werden sollen (True) oder nicht (False). Alternativ legen Sie das gewünschte Verhalten fix standardmäßig über die Eigenschaft XMLoutput im Control-Eigenschaftenpanel im FormDesigners fest.
¶ Overflow bei TextBoxen
Eine Textbox hat eine bestimmte Breite (Eigenschaft Width) und eine maximale Anzahl von Zeichen (Eigenschaft MaxLength). Passt nun die maximale Anzahl der Zeichen nicht in die Breite der TextBox, entsteht ein Overflow. Dieser Overflow kann in eine weitere TextBox weitergeleitet werden.
Hinweis: Dies funktioniert nicht, wenn der Text über die Tastatur eingegeben wird, sondern nur, wenn der Text über eine Datenverbindung oder über eine Funktion eingelesen wird. Die Eigenschaften MultiLine, AutoSize und UseOverflow der TextBox müssen dazu auf True gesetzt werden.
¶ Beispiel
Auf der Formularseite gibt es zwei TextBoxen txt_1 und txt_2.
Eigenschaften von TextBox txt_1:
| Eigenschaft | Wert |
|---|---|
| Width | 135 |
| AutoSize | True |
| MultiLine | True |
| MaxLines | Den Wert von Height eintragen, damit nur eine Zeilenhöhe angezeigt wird. |
| MaxLength | 50 (mehr Zeichen, als gut in der TextBox sichtbar sind) |
| UseOverflow | True |
Wählen Sie mit einem Rechtsklick auf die TextBox txt_1 den Kontextmenüpunkt "Neue Funktion".
Es wird eine lokale Funktion erstellt. Tragen Sie im Funktionseditor folgendes ein:
IF (Bedingung)
Löschen Sie die vorhandene Bedingung
Eigenschaft: Overflow
Operation: ungleich
Übernehmen [F6]
THEN
Klicken Sie im Formular die zweite TextBox an
Eigenschaft: Text
Wert: [@txt_1.Overflow]
¶ Benutzerdefinierte Validierung – Reguläre Ausdrücke
Um Eingaben in einer TextBox gegen reguläre Ausdrücke zu prüfen, wählen Sie im Dialog zur Validierung unter den Textregeln Benutzerdefiniert aus. Nun können Sie auf der rechten Seite reguläre Ausdrücke zur Eingabeprüfung eintragen und in der TextBox darunter direkt Eingaben prüfen lassen, siehe Syntax und Beispiele.
Grundsätzlich können Sie im FormDesigner für die Validierung der Nutzereingabe leicht zwischen vielen vordefinierten Regeln wählen, z. B.
- E-Mail-Adresse
- Nur Buchstaben
- Postleitzahl
- Datumsangabe
- Unzulässige Zeichen
- u. v. m.
Die Eingabevalidierung wird zur Laufzeit des Formulars automatisch ausgeführt. Ungültige Eingaben werden für den Nutzer durch eine farbliche Markierung am Eingabefeld visuell hervorgehoben. Gleichzeitig kann das Ergebnis der Eingabevalidierung auch in Funktionen als Kriterium für die Ausführung weiterer Befehle verwendet werden, mittels der Überprüfung des Eigenschaftswert isValid.
¶ Eigenschaften
| Eigenschaft | Erklärung |
|---|---|
| MaskEdit | Eingabemaske (Eigenschaft Validationmode: MaskEdit) |
| MaxLenght | maximale Zeichenlänge |
| PasswordChar | Zeichen für Passworteingabe (*) |
| RegExPattern | Validierungsmodus (Eigenschaft Validationmode: RegularExpression) Auswahl einiger Vorgaben (E-Mail, URL, IP, Datum, Postleitzahlen) oder Erstellung einer benutzerdefinierten Vorlage (Custom) |
| Required | Angabe/Ausfüllen erforderlich Angabe: True (Ja) oder False (Nein), Standardwert: False |
| ShowErrorIcon | Anzeige eines Fehlersymbols bei falscher Eingabe Angabe: True (Ja) oder False (Nein), Standardwert: False |
| ToolTip | Angabe eines Hinweistextes bei Berühren des Textfeldes |
| ValidationMode | Einstellung, welcher Inhalt im Textfeld gültig ist Auswahl einiger Vorgaben (None, ValidCharacters, InvalidCharacters, Letters, Numbers, MaskEdit, RegularExpression) |
| ValidText | Gültiger Text |
| BackColor | Hintergrundfarbe |
| BorderStyle | Art des Rahmens um die TextBox Angaben: none (keiner), FixedSingle (einfacher Rahmen), Fixed3D (3D-Rahmen) Standard: none Hinweis: Die Farbe des Rahmens kann nicht verändert werden. |
| MultiLine | Automatische Anpassung der Höhe der TextBox mit Eingabe des Textes (Eigenschaft: MultiLine muss aktiviert sein) Angabe: True (Ja) oder False (Nein) |
| ReadOnly (bis Formularware 3.0 SP I = OnlyRead) | Nur Leserecht für das Textfeld aktivieren. Angabe: True (Ja) oder False (Nein), Standardwert: False |
¶ Benutzerdefinierte Reguläre Ausdrücke
Setzen der Eigenschaften:
RegExPattern >> CustomValidText >> regulärer Ausdruck
¶ Beispiele für Zeichenauswahl
| Eigenschaft | Erklärung |
|---|---|
| [egh] | eines der Zeichen „e“, „g“ oder „h“ |
| [0-6] | eine Ziffer von „0“ bis „6“ (Bindestriche sind Indikator für einen Bereich) |
| [A-Za-z0-9] | ein beliebiger lateinischer Buchstabe oder eine beliebige Ziffer |
| [^a] | ein beliebiges Zeichen außer „a“ („^“ am Anfang einer Zeichenklasse negiert selbige) |
| [-A-Z], [A-Z-] bzw. [A-Z\-a-z] | Auswahl enthält auch das Zeichen „-“, wenn es das erste oder das letzte Zeichen einer Zeichenklasse ist bzw. wenn seine Metafunktion innerhalb einer Auswahl durch ein vorangestelltes „\“-Zeichen aufgehoben wird |
¶ Beispiele für Zeichenauswahl
| Eigenschaft | Erklärung |
|---|---|
| [:alnum:] | Alphanumerische Zeichen: [:alpha:] oder [:digit:]. |
| [:alpha:] | Buchstaben: [:lower:] oder [:upper:]. |
| [:blank:] | Leerzeichen oder Tabulator. |
| [:cntrl:] | Steuerzeichen. Im ASCII sind das die Zeichen 00 bis 1F, und 7F (DEL). |
| [:digit:] | die Ziffern 0 bis 9. |
| [:graph:] | Graphische Zeichen: [:alnum:] oder [:punct:]. |
| [:lower:] | Kleinbuchstaben: nicht notwendigerweise nur von a bis z. |
| [:print:] | Druckbare Zeichen: [:alnum:], [:punct:] und Leerzeichen. |
| [:punct:] | Zeichen wie: ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~ . |
| [:space:] | Whitespace: Horizontaler und vertikaler Tabulator, Zeilen- und Seitenvorschub, Wagenrücklauf und Leerzeichen. |
| [:upper:] | Großbuchstaben: nicht notwendigerweise nur von A bis Z. |
| [:xdigit:] | Hexadezimale Ziffern: 0 bis 9, A bis F, a bis f. |
¶ Vordefinierte Zeichenklassen
| Eigenschaft | Erklärung |
|---|---|
| \d | eine Ziffer [0-9] |
| \D | ein Zeichen, das keine Ziffer ist, also [^\d] |
| \w | ein Buchstabe, eine Ziffer oder der Unterstrich, also [a-zA-Z_0-9] (und evtl. weitere Buchstaben, z. B. Umlaute) |
| \W | ein Zeichen, das weder Buchstabe noch Zahl noch Unterstrich ist, also [^\w] |
| \s | Whitespace; meistens die Klasse der Steuerzeichen \f, \n, \r, \t und \v |
| \S | ein Zeichen, das kein Whitespace ist [^\s] |
¶ Quantoren
| Eigenschaft | Erklärung |
|---|---|
| ? | Der voranstehende Ausdruck ist optional, er kann einmal vorkommen, muss es aber nicht, d. h. der Ausdruck kommt null- oder einmal vor. (Dies entspricht {0,1}) |
| + | Der voranstehende Ausdruck muss mindestens einmal vorkommen, darf aber auch mehrfach vorkommen. (Dies entspricht {1,}) |
| * | Der voranstehende Ausdruck darf beliebig oft (auch keinmal) vorkommen. (Dies entspricht {0,}) |
| {n} | Der voranstehende Ausdruck muss exakt n-mal vorkommen. |
| {min,} | Der voranstehende Ausdruck muss mindestens min-mal vorkommen. |
| {,max} | Der voranstehende Ausdruck darf maximal max-mal vorkommen. |
| {min,max} | Der voranstehende Ausdruck muss mindestens min-mal und darf maximal max-mal vorkommen. |