MaskedEdit-besturingselement
Het besturingselement MaskedEdit is een besturingselement voor bewerkingsvelden dat een masker bevat in het tekstveld van het besturingselement. U kunt het besturingselement koppelen aan een eigenschap tekenreekswaarde door de naam van de eigenschap in te voeren in de kolom Eigenschap van de Control Table.
U kunt het besturingselement MaskedEdit gebruiken om een sjabloon te maken voor het invoeren van gegevens door gebruikers, zoals een telefoonnummer of product-id-code. De eigenschap PIDKEY kan bijvoorbeeld door de gebruiker worden ingevoerd via een MaskedEdit-besturingselement dat is opgegeven door de eigenschap PIDTemplate in te stellen op een tekenreeks zoals hieronder:
12345<### -%%%%%%%>@@@@@
De tekenreeks definieert de maskeringssjabloon voor het invoeren van de PIDKEY eigenschap door de gebruiker. Het zichtbare segment van de tekenreeks staat tussen een paar haakjes (<>) tekens.
In de volgende tabel is de syntaxis van het masker geïdentificeerd.
| Karakter | Betekenis |
|---|---|
| < | Het linkereinde van het zichtbare segment van de sjabloon. Dit teken en alles aan de linkerkant zijn verborgen in de gebruikersinterface. Er mag niet meer dan één exemplaar van dit teken in de sjabloon staan. |
| > | Het rechtereinde van het zichtbare segment van de sjabloon. Dit teken en alles aan de rechterkant zijn verborgen in de gebruikersinterface. Dit teken wordt tijdens de validatie vervangen door een streepje. Als er een zichtbaar segment begint met <, moet het worden beëindigd met een overeenkomende >. |
| # | Dit teken kan een cijfer zijn (numeriek.) |
| % | Dit teken kan een alternatief cijfer (numeriek) zijn waarmee het masker de manier bepaalt waarop een aangepaste actie velden onderscheidt. |
| @ | Dit teken kan een willekeurig cijfer zijn (numeriek.) Dit teken mag niet worden weergegeven in het zichtbare deel van de sjabloon. |
| & | Dit teken kan elk teken zijn. |
| ^ | Dit teken kan een alternatief teken zijn waarmee het masker de manier bepaalt waarop een aangepaste actie velden onderscheidt. |
| ? | Dit teken kan een alternatief teken zijn waarmee het masker de manier bepaalt waarop een aangepaste actie velden onderscheidt. |
| ` | Accentmarkeringen grave ' (ASCII-waarde 96) kunnen een alternatief teken voorstellen waarmee het masker de manier bepaalt waarop een aangepaste actie velden onderscheidt. |
| _ | Dit teken is een letterlijk onderstrepingsteken. |
| = | Dit teken is het veldeindteken. Dit moet een #, %, ^of 'volgen. Hiermee maakt u nog één invoerpositie van hetzelfde type als de voorgaande posities en beëindigt u het veld met een scheidingsteken '-'. |
Elk ander teken wordt behandeld als een letterlijke constante.
Voor tekens die kunnen worden bewerkt, maakt het besturingselement afzonderlijke bewerkingsvensters met één venster voor elk blok aaneengesloten tekens van hetzelfde type.
Besturingskenmerken
Als u de waarde van een kenmerk wilt wijzigen dat gebruikmaakt van een gebeurtenis, abonneert u het besturingselement op een besturingselement in de EventMapping Table en vermeldt u de kenmerk-id in de kolom Kenmerk. Voer de id in van de gebeurtenis in de kolom Gebeurtenis. U kunt de volgende kenmerken gebruiken met het besturingselement MaskedEdit.
| Attribuut | Hexadecimale bit | Beschrijving |
|---|---|---|
| IndirectPropertyName | Dit is de naam van een indirecte eigenschap die is gekoppeld aan het besturingselement. Als de indirecte kenmerk-bit is ingesteld, wordt in het besturingselement de waarde van de eigenschap met deze naam weergegeven of gewijzigd. Als de indirecte kenmerk-bit is ingesteld, is deze naam ook de waarde van de eigenschap die wordt vermeld in de kolom Eigenschap van de Control Table. | |
| positie | Positie van het besturingselement in het dialoogvenster. Voer de breedte, hoogte en coördinaten van het besturingselement in de linkerhoek van het besturingselement in de kolommen Breedte, Hoogte, X en Y van de Control Tablein. Gebruik installatie-eenheden voor lengte en afstand. |
|
| PropertyName- | Dit is de naam van de eigenschap die aan dit besturingselement is gekoppeld. Als de indirecte kenmerk-bit niet is ingesteld, wordt in het besturingselement de waarde van de eigenschap met deze naam weergegeven of gewijzigd. Dit kenmerk wordt opgegeven in de kolom Eigenschap van de Control Table. | |
| PropertyValue- | Huidige waarde van de eigenschap die wordt weergegeven of gewijzigd door dit besturingselement. Als de indirecte kenmerk-bit niet is ingesteld, is dit de waarde van PropertyName. Als de indirecte kenmerk-bit is ingesteld, is dit de waarde van IndirectPropertyName. Als het kenmerk wordt gewijzigd, geeft het besturingselement de nieuwe waarde weer. | |
| tekst | Als u het lettertype en de tekenstijl van een tekenreeks wilt instellen, geeft u het voorvoegsel van de weergegeven tekens met {\style} of {&style}. Waar stijl een id is die wordt vermeld in de kolom Stijl van de TextStyle Table. Als geen van deze aanwezig is, maar de eigenschap DefaultUIFont is gedefinieerd als een geldige tekststijl, wordt dat lettertype gebruikt. De tekenreeks die de maskeringssjabloon opgeeft, volgt dit voorvoegsel en gebruikt de syntaxis die eerder in dit onderwerp is beschreven. | |
| zichtbare | 0x00000000 0x00000001 |
Verborgen besturingselement. Zichtbaar besturingselement. Neem deze bit op in het bitwoord van de kolom Kenmerken in de Besturingstabel om het besturingselement zichtbaar of verborgen te maken wanneer het wordt gemaakt. U kunt een besturingselement ook verbergen of weergeven met behulp van de ControlCondition Table. |
| ingeschakelde | 0x00000000 0x00000002 |
Besturingselement met een uitgeschakelde status. Besturingselement in een ingeschakelde status. Neem deze bit op in het bitwoord in de kolom Kenmerken van de Control Table om het besturingselement bij het maken in te schakelen. U kunt een besturingselement ook in- of uitschakelen met behulp van de ControlCondition Table. |
| 0x00000000 0x00000004 |
Hiermee wordt de standaardvisualstijl weergegeven. Geeft het besturingselement weer met een gezonken 3D-look. Neem deze bits op in het bitwoord in de kolom Kenmerken van de Control Table. |
|
| indirect | 0x00000000 0x00000008 |
Het besturingselement geeft de waarde van de eigenschap weer of wijzigt deze in de kolom Eigenschap van de Control Table. Het besturingselement geeft de waarde weer of wijzigt de waarde van de eigenschap met de id die wordt vermeld in de kolom Eigenschap van de Control Table. Bepaalt of de eigenschap die aan dit besturingselement is gekoppeld indirect wordt verwezen. |
Opmerkingen
Het besturingselement MaskedEdit maakt één bovenliggend venster van de BUTTON klasse met de stijlen BS_OWNERDRAW en WS_EX_CONTROLPARENT. Er worden verschillende onderliggende vensters voor dit venster gemaakt.
- Voor constante tekstonderdelen worden STATISCHE vensters gemaakt met de stijlen SS_LEFT en WS_CHILD.
- Voor bewerkbare velden wordt er een VENSTER BEWERKEN gemaakt met de WS_CHILD, WS_BORDERen WS_TABSTOP stijlen.
- Voor numerieke velden heeft het venster ook de stijl ES_NUMBER.
Met het alternatieve cijfer, %en alternatieve alfanumerieke tekens, ^, ?en ' kunnen aangepaste acties onderscheid maken tussen velden op een manier die kan worden bepaald door het masker, bijvoorbeeld ^ kunnen worden gebruikt voor velden die hoofdletters moeten zijn.