MaskedEdit, contrôle
Le contrôle MaskedEdit est un contrôle de champ d’édition qui contient un masque dans le champ de texte du contrôle. Vous pouvez associer le contrôle à une propriété de valeur de chaîne en entrant le nom de la propriété dans la colonne Propriété de la table de contrôles .
Vous pouvez utiliser le contrôle MaskedEdit pour créer un modèle pour l’entrée d’informations utilisateur telles qu’un numéro de téléphone ou un code d’ID de produit. Par exemple, la propriété PIDKEY peut être entrée par l’utilisateur via un contrôle MaskedEdit spécifié en définissant la propriété PIDTemplate sur une chaîne comme suit :
12345<### -%%%%%%%>@@@@@
La chaîne définit le modèle de masquage pour l’entrée de l'PIDKEY Property par l’utilisateur. Le segment visible de la chaîne est entouré d’une paire de caractères entre crochets (<>).
Le tableau suivant a identifié la syntaxe du masque.
| Personnage | Signification |
|---|---|
| < | Fin gauche du segment visible du modèle. Ce caractère et tout à gauche sont masqués dans l’interface utilisateur. Il ne doit pas y avoir plus d’une instance de ce caractère dans le modèle. |
| > | Fin droite du segment visible du modèle. Ce caractère et tout à droite sont masqués dans l’interface utilisateur. Ce caractère est remplacé par un tiret pendant la validation. S’il existe un segment visible commence par <, il doit être arrêté avec une >correspondante. |
| # | Ce caractère peut être un chiffre (chiffres.) |
| % | Ce caractère peut être un autre chiffre (chiffres) qui permet au masque de contrôler la façon dont une action personnalisée différencie les champs. |
| @ | Ce caractère peut être un chiffre aléatoire (chiffres.) Ce caractère ne doit pas apparaître dans la partie visible du modèle. |
| & | Ce caractère peut être n’importe quel caractère. |
| ^ | Ce caractère peut être un autre caractère qui permet au masque de contrôler la façon dont une action personnalisée différencie les champs. |
| ? | Ce caractère peut être un autre caractère qui permet au masque de contrôler la façon dont une action personnalisée différencie les champs. |
| ` | Les marques d’accentuation grave ' (valeur ASCII 96) peuvent représenter un autre caractère qui permet au masque de contrôler la façon dont une action personnalisée différencie les champs. |
| _ | Ce caractère est un caractère de soulignement littéral. |
| = | Ce caractère est la marque de fin de champ. Cela doit suivre un #, %, ^ou '. Cela crée une position d’entrée supplémentaire du même type que les positions précédentes et met fin au champ avec un séparateur « - ». |
Tout autre caractère est traité comme une constante littérale.
Pour les caractères qui peuvent être modifiés, le contrôle crée des fenêtres d’édition distinctes avec une fenêtre pour chaque bloc de caractères contigus du même type.
Attributs de contrôle
Pour modifier la valeur d’un attribut qui utilise un événement, abonnez-vous au contrôle à un événement Control dans la table eventMapping et répertoriez l’identificateur d’attribut dans la colonne Attribut. Entrez l’identificateur de l’événement Control dans la colonne Événement. Vous pouvez utiliser les attributs suivants avec le contrôle MaskedEdit.
| Attribut | Bit hexadécimal | Description |
|---|---|---|
| indirectPropertyName | Il s’agit du nom d’une propriété indirecte associée au contrôle. Si le bit d’attribut indirect est défini, le contrôle affiche ou modifie la valeur de la propriété qui a ce nom. Si le bit d’attribut indirect est défini, ce nom est également la valeur de la propriété répertoriée dans la colonne Propriété de la table de contrôle . | |
| position | Position du contrôle dans la boîte de dialogue. Entrez la largeur de contrôle, la hauteur et les coordonnées du coin gauche du contrôle dans les colonnes Width, Height, X et Y de la table de contrôles . Utilisez unités d’installation pour la longueur et la distance. |
|
| PropertyName | Il s’agit du nom de la propriété associée à ce contrôle. Si le bit d’attribut indirect n’est pas défini, le contrôle affiche ou modifie la valeur de la propriété portant ce nom. Cet attribut est spécifié dans la colonne Propriété de la table de contrôles . | |
| PropertyValue | Valeur actuelle de la propriété affichée ou modifiée par ce contrôle. Si le bit d’attribut indirect n’est pas défini, il s’agit de la valeur de PropertyName. Si le bit d’attribut indirect est défini, il s’agit de la valeur indirectPropertyName. Si l’attribut change, le contrôle reflète la nouvelle valeur. | |
| texte | Pour définir la police et le style de police d’une chaîne de texte, préfixez la chaîne de caractères affichés avec {\style} ou {&style}. Où le style est un identificateur répertorié dans la colonne Style de la table TextStyle . Si aucun de ces éléments n’est présent, mais que la DefaultUIFont Property est définie comme un style de texte valide, cette police est utilisée. La chaîne qui spécifie le modèle de masquage suit ce préfixe et utilise la syntaxe décrite précédemment dans cette rubrique. | |
| visible | 0x00000000 0x00000001 |
Contrôle masqué. Contrôle visible. Incluez ce bit dans le mot bit de la colonne Attributs de la table de contrôles pour rendre le contrôle visible ou masqué lors de sa création. Vous pouvez également masquer ou afficher un contrôle à l’aide de l'ControlCondition Table. |
| activé | 0x00000000 0x00000002 |
Contrôle dans un état désactivé. Contrôle dans un état activé. Incluez ce bit dans le mot de bits dans la colonne Attributs de la table de contrôles pour activer le contrôle lors de la création. Vous pouvez également activer ou désactiver un contrôle à l’aide du ControlCondition Table. |
| Sunken | 0x00000000 0x00000004 |
Affiche le style visuel par défaut. Affiche le contrôle avec une apparence 3D enfoncée. Incluez ces bits dans le mot de bits dans la colonne Attributs de la table de contrôles . |
| indirect | 0x00000000 0x00000008 |
Le contrôle affiche ou modifie la valeur de la propriété dans la colonne Propriété de la table de contrôle . Le contrôle affiche ou modifie la valeur de la propriété qui contient l’identificateur répertorié dans la colonne Propriété de la table de contrôles . Détermine si la propriété associée à ce contrôle est référencée indirectement. |
Remarques
Le contrôle MaskedEdit crée une fenêtre parente de la classe BUTTON avec les styles BS_OWNERDRAW et WS_EX_CONTROLPARENT. Il crée plusieurs fenêtres enfants dans cette fenêtre.
- Pour les parties de texte constantes, il crée des fenêtres STATIC avec les styles SS_LEFT et WS_CHILD.
- Pour les champs modifiables, il crée une fenêtre EDIT avec les styles WS_CHILD, WS_BORDERet WS_TABSTOP.
- Pour les champs numériques, la fenêtre a également le style ES_NUMBER.
Les autres chiffres, %et caractères alphanumériques alternatifs, ^, ?et ' permettent aux actions personnalisées de différencier les champs d’une manière qui peut être contrôlée par le masque, par exemple^ peut être utilisé pour les champs qui doivent être majuscules.