Eingabe

Das Steuerelement Eingabe dient der einfachen Benutzereingabe von beliebigem Text.

Parameter - Der Parameter, der den Wert dieses Steuerelements zugewiesen bekommt. Der Wert, den der Parameter bekommt, wird über die Eigenschaft Text (bzw. die Benutzereingabe) definiert.

Keine zwei Steuerelemente dürfen den selben Parameter zugewiesen bekommen. Sollten doch zwei Elemente den selben Parameter zugewiesen bekommen, wird in den Statusinformationen der Punkt Parameter eindeutig rot markiert. Sollte einem Steuerelement, das die Eigenschaft Parameter besitzt, kein solcher zugeordnet sein, wird der Punkt Parameter zugewiesen rot markiert, um Sie darauf hinzuweisen. Im Kasten Liste der Steuerelemente können Sie die ungültigen Steuerelemente gezielt auswählen.

Anchors - Legt fest, wie sich das Steuerelement bei Größenänderungen des Eingabefensters verhält.

Die verankerten Ecken (Anchors) behalten beim Verkleinern oder Vergrößern des Fensters ihre absolute Position bezüglich der Fensterränder bei. Die Eigenschaft Anchors ist dabei eine Menge aus folgenden Werten, die festlegt, welche Seiten verankert sind:

In der Standardeinstellung [akLeft,akTop] behält das Steuerelement immer eine feste Position bezüglich der linken oberen Ecke des Fensters bei. Mit [akRight,akBottom] wäre die Position fix bezüglich der rechten, unteren Ecke. Bei beispielsweise [akLeft,akRight] bleibt der Abstand der linken bzw. rechten Seite des Steuerelements immer gleich zur linken bzw. rechten Seite des Fensters; das bedeutet, bei einer Verbreiterung des Fensters wird auch das Steuerelement breiter und bei einer Verkleinerung wird es ebenfalls kleiner. Durch passendes Setzen der Anchor-Werte bleibt das Layout des Eingabefensters auch bei Größenanpassungen durch den Benutzer erhalten.

AutoFill - Bewirkt, bei vorgegebener PictureMask, dass die Benutzereingabe automatisch vervollständigt wird, sofern dies möglich ist.

Font - Schriftart, -eigenschaften, -größe und -farbe, mit denen der Text des Steuerelements angezeigt wird.

Hint - Text, der als Tool-Tip / Hint angezeigt wird, wenn der Mauszeiger vom Benutzer für längere Zeit auf dem Steuerelement positioniert wird.

Wird hier ein Wert ungleich #0 angegeben, dann wird statt des jeweils eingegeben Zeichens lediglich dieses angezeigt. Ein typisches Zeichen wäre beispielsweise das *. Die Eingabe passwort würde dann als ******** angezeigt. Der zugewiesene Parameter würde aber trotzdem den Wert passwort bekommen.

PictureMask - Über diese Eigenschaft können Sie die Eingabe des Benutzers auf bestimmte Zeichen oder Zeichenfolgen einschränken.

Über die PictureMask können Sie über Platzhalter eine Eingabemaske für die Benutzereingabe definieren. Diese kann beispielsweise festlegen, dass nur bestimmte Zeichen erlaubt sind, oder, dass die Eingabe automatisch in Groß- oder Kleinschreibung konvertiert wird. Sie können über diese Eigenschaft auch gezielt Begriffe vorgeben, die eingegeben werden können. Das Steuerelement würde dann keine anderen Begriffe, als die vorgegebenen akzeptieren. Die folgenden Platzhalter sind in der PictureMask möglich:

•	& - Beliebiger Buchstabe (a-z, A-Z), die Eingabe wird automatisch in Großbuchstaben konvertiert.

•	~ - Beliebiger Buchstabe (a-z, A-Z), die Eingabe wird automatisch in Kleinbuchstaben konvertiert.

•	; - Escape-Zeichen: Legt fest, dass das nachfolgende Zeichen nicht als Platzhalter der PictureMask angesehen werden soll.

•

* - Wiederholungszeichen: Legt fest, dass das nachfolgende Zeichen bzw. der nachfolgende Platzhalter beliebig oft wiederholt werden darf. Beispielsweise erlaubt die Maske *& die Eingabe beliebig vieler Buchstaben, die automatisch in Großbuchstaben konvertiert werden. Folgt auf das *-Zeichen eine Zahl, so gibt diese die Anzahl der Wiederholungen an, z.B. erfordert die Maske *5{#} die Eingabe von fünf Ziffern.

•	[abc] - Eckige Klammern markieren optionale Elemente der Maske. Die Zeichen innerhalb der eckigen Klammern sind optional und müssen nicht eingegeben werden. Die Maske a[b] erlaubt die Eingabe von entweder a oder ab.

•

{a,b,c} - Geschweifte Klammern definieren Gruppen. Der Benutzer muss an der entsprechenden Stelle eine der in den Klammern definierten Zeichenfolgen eingeben, dabei darf es sich um Platzhalter handeln. Zum Beispiel muss der Benutzer bei der Maske {Haus,Garten,Auto} einen der drei Begriffe eingeben. Die einzelnen Begriffe in der Klammer müssen eindeutig sein, eine Maske wie {Haus,Hausboot,Garten} wäre ungültig. Statt dessen sollte die Maske {Haus[boot],Garten} verwendet werden.

RegExp - Regulärer Ausdruck, über den je nach gewähltem RegExpType die Benutzereingabe überprüft oder nachträglich verändert werden kann. Näheres siehe RegExpType.

RegExpTemplate - Text, durch den die Teile der Eingabe ersetzt werden sollen, die auf den regulären Ausdruck aus RegExp passen. Wird nur berücksichtigt, wenn RegExpType den Wert rtsSubsitute oder rtsReplace hat.

RegExpType - Legt fest, ob und wie der reguläre Ausdruck aus RegExp auf die Benutzereingabe angewendet werden soll. Folgende Werte sind möglich:

•	rtsValidate - Die Eingabe wird mittels des regulären Ausdrucks auf Gültigkeit überprüft. Passt die Eingabe nicht auf den Ausdruck, dann wird dem Benutzer eine entsprechende Fehlermeldung angezeigt.

•	rtsSubstitute - Mittels des regulären Ausdrucks wird nach passenden Passagen in der Benutzereingabe gesucht, die dann durch den in RegExpTemplate angegebenen Text ersetzt werden.

TabOrder - Legt fest, in welcher Reihenfolge die Steuerelemente im Eingabefenster mittels der Tabulator-Taste durchgeschaltet werden können.

Beim Anzeigen des Eingabefensters bekommt das Steuerelement des Fensters den Eingabefokus, welches den niedrigsten TabOrder-Wert hat. Durch Drücken der Tabulator-Taste wird der Fokus dann auf das Element gewechselt, das den nächst größeren TabOrder-Wert hat. Elemente, die in einer logischen Reihenfolge stehen, sollten aufsteigende TabOrder-Werte zugewiesen bekommen. So kann der Benutzer bequem per Tastendruck durch diese hindurchschalten, ohne die Maus benutzen zu müssen und ohne, dass der Eingabefokus wild hin und her springt. Alle Steuerelemente, außer Text und Grafik, können den Eingabefokus bekommen.

Task - Definiert, ob es sich um eine Pflichteingabe handelt (true) oder ob eine leere Eingabe erlaubt ist (false).

Nur wenn für alle Steuerelemente, deren Eigenschaft Task den Wert true hat, eine Eingabe gemacht wurde, kann das Template ausgeführt werden. Im Fall des Eingabefeldes bedeutet dies, dass Text eingegeben sein muss.

Text - Im Eingabefeld angezeigter Text. Kann z.B. für Vorgabewerte verwendet werden.

TrimText - Legt fest, ob Leerzeichen vor und/oder hinter dem eingegebenen Text abgeschnitten werden sollen oder nicht.