MaskedEdit-Steuerelement
Das MaskedEdit-Steuerelement ist ein Steuerelement für ein Bearbeitungsfeld, das eine Maske im Textfeld des Steuerelements enthält. Sie können dieses Steuerelement einer Eigenschaft mit einem Zeichenfolgenwert zuordnen, indem Sie den Namen der Eigenschaft in die Spalte „Eigenschaft“ der Tabelle Control eingeben.
Sie können das MaskedEdit-Steuerelement verwenden, um eine Vorlage für die Benutzereingabe von Informationen wie Telefonnummern oder Produkt-IDs zu erstellen. Beispielsweise kann die PIDKEY-Eigenschaft von Benutzer*innen über ein MaskedEdit-Steuerelement eingegeben werden, das durch Festlegen der PIDTemplate-Eigenschaft auf eine Zeichenfolge wie die folgende angegeben wird:
12345<### -%%%%%%%>@@@@@
Die Zeichenfolge definiert die Maskierungsvorlage für die Eingabe der PIDKEY-Eigenschaft durch Benutzer*innen. Das sichtbare Segment der Zeichenfolge wird in zwei Klammern (<>) eingeschlossen.
In der folgenden Tabelle finden Sie die Syntax der Maske.
| Zeichen | Bedeutung |
|---|---|
| < | Das linke Ende des sichtbaren Bereichs der Vorlage. Dieses Zeichen und alles links davon wird auf der Benutzeroberfläche ausgeblendet. Die Vorlage sollte dieses Zeichen höchstens einmal enthalten. |
| > | Das rechte Ende des sichtbaren Bereichs der Vorlage. Dieses Zeichen und alles rechts davon werden auf der Benutzeroberfläche ausgeblendet. Dieses Zeichen wird während der Überprüfung durch einen Bindestrich ersetzt. Wenn ein sichtbares Segment mit < beginnt, muss es mit > beendet werden. |
| # | Dieses Zeichen kann eine Ziffer (numerisch) sein. |
| % | Dieses Zeichen kann eine alternative Ziffer (numerisch) sein, mit der die Maske steuern kann, wie eine benutzerdefinierte Aktion Felder unterscheidet. |
| @ | Dieses Zeichen kann eine zufällige Ziffer (numerisch) sein, und es sollte nicht im sichtbaren Teil der Vorlage angezeigt werden. |
| & | Dieses Zeichen kann ein beliebiges Zeichen sein. |
| ^ | Dieses Zeichen kann ein alternatives Zeichen sein, mit dem die Maske steuern kann, wie eine benutzerdefinierte Aktion Felder unterscheidet. |
| ? | Dieses Zeichen kann ein alternatives Zeichen sein, mit dem die Maske steuern kann, wie eine benutzerdefinierte Aktion Felder unterscheidet. |
| ` | Das Graviszeichen „`“ (ASCII-Code 96) kann ein alternatives Zeichen sein, mit dem die Maske steuern kann, wie eine benutzerdefinierte Aktion Felder unterscheidet. |
| _ | Dieses Zeichen ist das Literalzeichen Unterstrich. |
| = | Dieses Zeichen ist der Feldabschluss. Es muss auf #, %, ^ oder ` folgen. Dadurch wird eine weitere Eingabeposition vom selben Typ wie an der vorherigen Positionen erstellt. Außerdem wird das Feld mit dem Trennzeichen „-“ beendet. |
Alle anderen Zeichen werden wie Literalkonstanten behandelt.
Für Zeichen, die bearbeitet werden können, erstellt das Steuerelement separate Bearbeitungsfenster – jeweils ein Fenster für jeden Block mit zusammenhängenden Zeichen desselben Typs.
Steuerelementattribute
Um den Wert eines Attributs zu ändern, das ein Ereignis verwendet, muss das Steuerelement ein Steuerelementereignis in der Tabelle EventMapping abonnieren, und der Bezeichner des Attributs muss in der Spalte „Attribute“ aufgeführt sein. Geben Sie den Bezeichner des Steuerelementereignisses in die Spalte „Event“ ein. Sie können beim MaskedEdit-Steuerelement die folgenden Attribute verwenden.
| attribute | Hexadezimales Bit | BESCHREIBUNG |
|---|---|---|
| IndirectPropertyName | Dies ist der Name einer indirekten Eigenschaft, die dem Steuerelement zugeordnet ist. Wenn das Indirect-Attributbit festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert ihn. Wenn das Indirect-Attributbit festgelegt ist, ist dieser Name auch der Wert der Eigenschaft, die in der Spalte „Property“ der Tabelle Control aufgeführt ist. | |
| Position | Position des Steuerelements im Dialogfeld. Geben Sie Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten „Width“, „Height“, „X“ und „Y“ der Tabelle Control ein. Verwenden Sie Installationseinheiten für Länge und Abstand. |
|
| PropertyName | Der Name der Eigenschaft, die diesem Steuerelement zugeordnet ist. Wenn das Indirect-Attributbit nicht festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert ihn. Dieses Attribut wird in der Spalte „Property“ der Tabelle Control angegeben. | |
| PropertyValue | Der aktuelle Wert der Eigenschaft, die von diesem Steuerelement angezeigt oder geändert wird. Wenn das Indirect-Attributbit nicht festgelegt ist, ist dies der Wert von PropertyName. Wenn das Indirect-Attributbit festgelegt ist, ist dies der Wert von IndirectPropertyName. Wenn sich das Attribut ändert, spiegelt das Steuerelement den neuen Wert wider. | |
| Text | Um die Schriftart und den Schriftstil einer Textzeichenfolge festzulegen, stellen Sie der Zeichenfolge der angezeigten Zeichen {\style} oder {&style} voran. Dabei ist „style“ ein Bezeichner, der in der Spalte „Style“ der Tabelle TextStyle aufgeführt ist. Wenn keines dieser Elemente vorhanden ist, aber die DefaultUIFont-Eigenschaft als gültiger Textstil definiert ist, wird diese Schriftart verwendet. Die Zeichenfolge, die die Maskierungsvorlage angibt, folgt auf dieses Präfix. Dabei gilt die zuvor in diesem Thema beschriebene Syntax. | |
| Visible | 0x00000000 0x00000001 |
Ausgeblendetes Steuerelement. Sichtbares Steuerelement. Fügen Sie dieses Bit in das Bitwort der Spalte „Attributes“ der Tabelle Control ein, damit das Steuerelement bei seiner Erstellung sichtbar ist oder ausgeblendet wird. Sie können ein Steuerelement auch mithilfe der Tabelle ControlCondition ausblenden oder anzeigen. |
| Aktiviert | 0x00000000 0x00000002 |
Steuerelement in einem deaktivierten Zustand. Steuerelement ist aktiviert. Fügen Sie dieses Bit in das Bitwort in die Spalte „Attributes“ der Tabelle Control ein, um das Steuerelement bei der Erstellung zu aktivieren. Sie können ein Steuerelement auch über die Tabelle ControlCondition aktivieren oder deaktivieren. |
| Sunken | 0x00000000 0x00000004 |
Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem vertieften 3D-Effekt an. Fügen Sie diese Bits in das Bitwort in die Spalte „Attributes“ der Tabelle Control ein. |
| Indirekt | 0x00000000 0x00000008 |
Das Steuerelement zeigt den Wert der Eigenschaft in der Spalte „Property“ der Tabelle Control an oder ändert ihn. Das Steuerelement zeigt den Wert der Eigenschaft an, deren Bezeichner in der Spalte „Property“ der Tabelle Control aufgelistet ist, oder ändert ihn. Bestimmt, ob indirekt auf die diesem Steuerelement zugeordnete Eigenschaft verwiesen wird. |
Bemerkungen
Das MaskedEdit-Steuerelement erstellt ein übergeordnetes Fenster der BUTTON-Klasse mit den Stilen BS_OWNERDRAW und WS_EX_CONTROLPARENT. Es erstellt in diesem Fenster mehrere untergeordnete Fenster.
- Für konstante Textabschnitte werden STATISCHE Fenster mit den Stilen SS_LEFT und WS_CHILD erstellt.
- Für bearbeitbare Felder wird ein Bearbeitungsfenster (EDIT) mit den Stilen WS_CHILD, WS_BORDER und WS_TABSTOP erstellt.
- Bei numerischen Feldern weist das Fenster auch den Stil ES_NUMBER auf.
Felder mit der alternativen Ziffer „%“ und mit alternativen alphanumerischen Zeichen „^“, „?“ und „`“ ermöglichen benutzerdefinierten Aktionen, zwischen Feldern auf eine Weise zu unterscheiden, die durch die Maske gesteuert werden kann. So kann z. B. „^“ für Felder verwendet werden, die Großbuchstaben enthalten sollten.