MaskedEdit-kontroll
Kontrollen MaskedEdEdit är en kontroll för redigeringsfält som innehåller en mask i kontrollens textfält. Du kan associera kontrollen med en strängvärdeegenskap genom att ange egenskapsnamnet i kolumnen Egenskap i -kontrolltabellen.
Du kan använda Kontrollen MaskedEdit för att skapa en mall för användarinmatning av information, till exempel ett telefonnummer eller produkt-ID-kod. Till exempel kan PIDKEY-egenskapen anges av användaren via en MaskedEdit-kontroll som anges genom att ange egenskapen PIDTemplate till en sträng som följande:
12345<### –%%%%%%%>@@@@@
Strängen definierar maskeringsmallen för posten för PIDKEY- egenskap av användaren. Strängens synliga segment omges av ett par hakparenteser (<>) tecken.
I följande tabell identifierades maskens syntax.
| Karaktär | Betydelse |
|---|---|
| < | Den vänstra änden av det synliga segmentet i mallen. Det här tecknet och allt till vänster döljs i användargränssnittet. Det får inte finnas fler än en instans av det här tecknet i mallen. |
| > | Den högra änden av det synliga segmentet i mallen. Det här tecknet och allt till höger döljs i användargränssnittet. Det här tecknet ersätts av ett bindestreck under valideringen. Om det finns ett synligt segment som börjar med <måste det avslutas med en matchande >. |
| # | Det här tecknet kan vara en siffra (siffror.) |
| % | Det här tecknet kan vara en alternativ siffra (siffror) som gör att masken kan styra hur en anpassad åtgärd skiljer fält åt. |
| @ | Det här tecknet kan vara en slumpmässig siffra (siffror.) Det här tecknet bör inte visas i den synliga delen av mallen. |
| & | Det här tecknet kan vara valfritt tecken. |
| ^ | Det här tecknet kan vara ett alternativt tecken som gör att masken kan styra hur en anpassad åtgärd skiljer fält åt. |
| ? | Det här tecknet kan vara ett alternativt tecken som gör att masken kan styra hur en anpassad åtgärd skiljer fält åt. |
| ` | Gravaccentertecken (ASCII-värde 96) kan representera ett alternativt tecken som gör det möjligt för masken att styra hur en anpassad åtgärd skiljer fält åt. |
| _ | Det här tecknet är ett literalt understreck. |
| = | Det här tecknet är fältavgränsaren. Detta måste följa ett #, %, ^eller .. Detta skapar ytterligare en indataposition av samma typ som föregående positioner och avslutar fältet med en "-" avgränsare. |
Alla andra tecken behandlas som en literalkonstant.
För tecken som kan redigeras skapar kontrollen separata redigeringsfönster med ett fönster för varje block med sammanhängande tecken av samma slag.
Kontrollattribut
Om du vill ändra värdet för ett attribut som använder en händelse prenumererar du på en kontrollhändelse i EventMapping-tabellen och listar attributidentifieraren i kolumnen Attribut. Ange identifieraren för kontrollhändelsen i kolumnen Händelse. Du kan använda följande attribut med kontrollen MaskedEdit.
| Attribut | Hexadecimal Bit | Beskrivning |
|---|---|---|
| IndirectPropertyName | Det här är namnet på en indirekt egenskap som är associerad med kontrollen. Om den indirekta attributbiten har angetts visar eller ändrar kontrollen värdet för den egenskap som har det här namnet. Om den indirekta attributbiten anges är det här namnet också värdet för egenskapen som visas i kolumnen Egenskap i Kontrolltabell. | |
| position | Kontrollens position i dialogrutan. Ange kontrollbredden, höjden och koordinaterna för kontrollens vänstra hörn i kolumnerna Width, Height, X och Y i Control Table. Använd installationsenheter för längd och avstånd. |
|
| PropertyName | Det här är namnet på den egenskap som är associerad med den här kontrollen. Om den indirekta attributbiten inte har angetts visar eller ändrar kontrollen värdet för den egenskap som har det här namnet. Det här attributet anges i kolumnen Egenskap i Kontrolltabell. | |
| PropertyValue | Aktuellt värde för egenskapen som visas eller ändras av den här kontrollen. Om den indirekta attributbiten inte har angetts är detta värdet för PropertyName. Om den indirekta attributbiten anges är det värdet för IndirectPropertyName. Om attributet ändras återspeglar kontrollen det nya värdet. | |
| Text | Om du vill ange teckensnittet och teckensnittsformatet för en textsträng prefixar du strängen med tecken som visas med {\style} eller {&style}. Där formatmallen är en identifierare som anges i kolumnen Format i TextStyle Table. Om inget av dessa finns, men egenskapen DefaultUIFont definieras som ett giltigt textformat, används det teckensnittet. Strängen som anger maskeringsmallen följer det här prefixet och använder syntaxen som beskrivs tidigare i det här avsnittet. | |
| synlig | 0x00000000 0x00000001 |
Dold kontroll. Synlig kontroll. Inkludera den här biten i bitordet i kolumnen Attribut i Kontrolltabell för att göra kontrollen synlig eller dold när den skapas. Du kan också dölja eller visa en kontroll med hjälp av ControlCondition Table. |
| aktiverat | 0x00000000 0x00000002 |
Kontroll i inaktiverat tillstånd. Kontroll i ett aktiverat tillstånd. Inkludera den här biten i bitordet i kolumnen Attribut i Kontrolltabell för att aktivera kontrollen när den skapas. Du kan också aktivera eller inaktivera en kontroll med hjälp av ControlCondition Table. |
| nedsänkt | 0x00000000 0x00000004 |
Visar standardformatet för visuella objekt. Visar kontrollen med en nedsänkt 3D-look. Inkludera dessa bitar i bitordet i kolumnen Attribut i Kontrolltabell. |
| Indirekt | 0x00000000 0x00000008 |
Kontrollen visar eller ändrar värdet för egenskapen i kolumnen Egenskap i Kontrolltabell. Kontrollen visar eller ändrar värdet för egenskapen som innehåller identifieraren i kolumnen Egenskap i Kontrolltabell. Avgör om egenskapen som är associerad med den här kontrollen refereras indirekt. |
Anmärkningar
Kontrollen MaskedEdit skapar ett överordnat fönster i BUTTON--klassen med formatmallarna BS_OWNERDRAW och WS_EX_CONTROLPARENT. Det skapar flera underordnade fönster till det här fönstret.
- För konstanta textdelar skapar den STATIC-fönster med formatmallarna SS_LEFT och WS_CHILD.
- För redigerbara fält skapas ett REDIGERINGsfönster med formatmallarna WS_CHILD, WS_BORDERoch WS_TABSTOP.
- För numeriska fält har fönstret också formatet ES_NUMBER.
Den alternativa siffran, %och alternativa alfanumeriska tecken, ^, ?, och fälten gör det möjligt för anpassade åtgärder att skilja mellan fält på ett sätt som kan styras av masken, till exempel ^ kan användas för fält som ska vara versaler.