MaskedEdIt-Steuerelement
Das MaskedEdit-Steuerelement ist ein Bearbeitungsfeld-Steuerelement, das ein Format im Textfeld des Steuerelements enthält. Sie können das Steuerelement einer Zeichenfolgenwerteigenschaft zuordnen, indem Sie den Eigenschaftennamen in die Eigenschaftsspalte der Steuerelementtabelleeingeben.
Sie können das MaskedEdit-Steuerelement verwenden, um eine Vorlage für die Benutzereingabe von Informationen zu erstellen, z. B. eine Telefonnummer oder einen Produktcode. Beispielsweise kann die PIDKEY--Eigenschaft vom Benutzer über ein MaskedEdit-Steuerelement eingegeben werden, das durch Festlegen der PIDTemplate Property auf eine Zeichenfolge wie die folgende angegeben wird:
12345<### -%%%%%%%>@@@@@
Die Zeichenfolge definiert die Maskierungsvorlage für den Eintrag des PIDKEY Property des Benutzers. Das sichtbare Segment der Zeichenfolge wird durch ein paar eckige Zeichen (<>) eingeschlossen.
In der folgenden Tabelle wurde die Syntax der Maske identifiziert.
| Zeichen | Bedeutung |
|---|---|
| < | Das linke Ende des sichtbaren Abschnitts der Vorlage. Dieses Zeichen und alles links sind in der Benutzeroberfläche ausgeblendet. Es sollte nicht mehr als eine Instanz dieses Zeichens in der Vorlage vorhanden sein. |
| > | Das rechte Ende des sichtbaren Abschnitts der Vorlage. Dieses Zeichen und alles rechts sind auf der Benutzeroberfläche ausgeblendet. Dieses Zeichen wird während der Überprüfung durch einen Gedankenstrich ersetzt. Wenn ein sichtbares Segment mit <beginnt, muss es mit einem übereinstimmenden >beendet werden. |
| # | Dieses Zeichen kann eine Ziffer (Zahl) sein.) |
| % | Dieses Zeichen kann eine alternative Ziffer (Zahl) sein, mit der das Format steuern kann, wie eine benutzerdefinierte Aktion Felder unterscheidet. |
| @ | Dieses Zeichen kann eine zufällige Ziffer (Zahl)sein.) Dieses Zeichen 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 das Format steuern kann, wie eine benutzerdefinierte Aktion Felder unterscheidet. |
| ? | Dieses Zeichen kann ein alternatives Zeichen sein, mit dem das Format steuern kann, wie eine benutzerdefinierte Aktion Felder unterscheidet. |
| ` | Grave accent marks ' (ASCII value 96) can represent an alternate character that enables the mask to control the way a custom action differenzs fields. |
| _ | Dieses Zeichen ist ein Literal unterstrich. |
| = | Dieses Zeichen ist der Feldendpunktator. Dies muss einem #, %, ^oder 'folgen. Dadurch wird eine weitere Eingabeposition desselben Typs wie die vorherigen Positionen erstellt und das Feld mit einem Trennzeichen "-" beendet. |
Jedes andere Zeichen wird als Literalkonstante behandelt.
Für Zeichen, die bearbeitet werden können, erstellt das Steuerelement separate Bearbeitungsfenster mit einem Fenster für jeden Block zusammenhängender Zeichen derselben Art.
Steuerelementattribute
Um den Wert eines Attributs zu ändern, das ein Ereignis verwendet, abonnieren Sie das Steuerelement in der EventMapping Table, und listen Sie den Attributbezeichner in der Attributspalte auf. Geben Sie den Bezeichner des Steuerelementereignisses in die Spalte "Ereignis" ein. Sie können die folgenden Attribute mit dem MaskedEdit-Steuerelement verwenden.
| Attribut | Hexadezimales Bit | Beschreibung |
|---|---|---|
| IndirectPropertyName | Dies ist der Name einer indirekten Eigenschaft, die dem Steuerelement zugeordnet ist. Wenn das indirekte Attributbit festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert sie. Wenn das indirekte Attributbit festgelegt ist, ist dieser Name auch der Wert der Eigenschaft, die in der Spalte "Eigenschaft" der Steuerelementtabelleaufgeführt ist. | |
| Position | Position des Steuerelements im Dialogfeld. Geben Sie die Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten Breite, Höhe, X und Y der Steuerelementtabelleein. Verwenden Sie Installationseinheiten für Länge und Entfernung. |
|
| PropertyName- | Dies ist der Name der Eigenschaft, die diesem Steuerelement zugeordnet ist. Wenn das indirekte Attributbit nicht festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert sie. Dieses Attribut wird in der Eigenschaftsspalte der Steuerelementtabelleangegeben. | |
| PropertyValue- | Aktueller Wert der Eigenschaft, die von diesem Steuerelement angezeigt oder geändert wird. Wenn das indirekte Attributbit nicht festgelegt ist, ist dies der Wert von PropertyName. Wenn das indirekte Attribut bit festgelegt ist, ist dies der Wert von IndirectPropertyName. Wenn sich das Attribut ändert, gibt das Steuerelement den neuen Wert wieder. | |
| Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, präfixen Sie die Zeichenfolge der angezeigten Zeichen mit {\style} oder {&style}. Dabei handelt es sich um einen Bezeichner, der in der Spalte "Formatvorlage" der "TextStyle-Tabelle"aufgeführt ist. Wenn keine dieser Eigenschaften vorhanden ist, aber die DefaultUIFont Property als gültige Textformatvorlage definiert ist, wird diese Schriftart verwendet. Die Zeichenfolge, die die Maskierungsvorlage angibt, folgt diesem Präfix und verwendet die zuvor in diesem Thema beschriebene Syntax. | ||
| Sichtbaren | 0x00000000 0x00000001 |
Ausgeblendetes Steuerelement. Sichtbares Steuerelement. Fügen Sie dieses Bit im Bitwort der Spalte "Attribute" in die Steuerelementtabelle ein, um das Steuerelement beim Erstellen sichtbar oder ausgeblendet zu machen. Sie können ein Steuerelement auch mithilfe der ControlCondition Tableausblenden oder anzeigen. |
| Aktivierte | 0x00000000 0x00000002 |
Steuerelement in einem deaktivierten Zustand. Steuerelement in einem aktivierten Zustand. Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" der Steuerelementtabelle ein, um das Steuerelement beim Erstellen zu aktivieren. Sie können ein Steuerelement auch mithilfe der ControlCondition Tableaktivieren oder deaktivieren. |
| sunken | 0x00000000 0x00000004 |
Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem versonnenen 3D-Look an. Fügen Sie diese Bits in das Bitwort in die Spalte "Attribute" der Steuerelementtabelleein. |
| Indirekte | 0x00000000 0x00000008 |
Das Steuerelement zeigt den Wert der Eigenschaft in der Eigenschaftsspalte der Steuerelementtabellean oder ändert sie. Das Steuerelement zeigt den Wert der Eigenschaft an, die den Bezeichner enthält, der in der Spalte "Eigenschaft" der Steuerelementtabelleaufgeführt ist. Bestimmt, ob auf die Eigenschaft, die diesem Steuerelement zugeordnet ist, indirekt verwiesen wird. |
Bemerkungen
Das MaskedEdit-Steuerelement erstellt ein übergeordnetes Fenster der BUTTON Klasse mit den Formatvorlagen BS_OWNERDRAW und WS_EX_CONTROLPARENT. Es erstellt mehrere untergeordnete Fenster für dieses Fenster.
- Für Konstantentextteile erstellt sie STATISCHE Fenster mit den formatvorlagen SS_LEFT und WS_CHILD.
- Bei bearbeitbaren Feldern wird ein EDIT-Fenster mit den Formatvorlagen WS_CHILD, WS_BORDERund WS_TABSTOP erstellt.
- Bei numerischen Feldern weist das Fenster auch die ES_NUMBER Formatvorlage auf.
Die alternative Ziffer, %und alternative alphanumerische Zeichen, ^, ?, und ' Felder ermöglichen benutzerdefinierte Aktionen die Unterscheidung zwischen Feldern auf eine Weise, die durch das Format gesteuert werden kann, z. B. ^kann für Felder verwendet werden, die Großbuchstaben sein sollen.