Modifier le contrôle (Windows Installer)
Le contrôle Edit est un champ de modification associé à une propriété chaîne ou valeur entière. Entrez le nom de la propriété dans la colonne Propriété de la table de contrôle .
Attributs de contrôle
Vous pouvez utiliser les attributs suivants avec ce contrôle. Pour modifier la valeur d’un attribut à l’aide d’un événement, abonnez-vous au contrôle à un ControlEvent dans la table EventMapping et répertoriez l’identificateur de l’attribut dans la colonne Attribut. Entrez l’identificateur de ControlEvent dans la colonne Événement.
| Identificateur d’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é portant 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, la hauteur et les coordonnées du contrôle dans les colonnes Width, Height, X et Y de la table contrôle . 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ôle . | |
| 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 TextStyle de la table TextStyle . Si aucun de ces éléments n’est présent, mais que la propriété DefaultUIFont est définie comme un style de texte valide, cette police sera utilisée. Pour spécifier le nombre de caractères que l’utilisateur peut entrer, ajoutez {n} après toutes les spécifications de police. Où n est un entier positif. |
|
| visible | 0x00000000 0x00000001 |
Contrôle masqué. Contrôle visible. Incluez ce bit dans le mot de bits de la colonne Attributs de la table de contrôle 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 la table ControlCondition. |
| activé | 0x00000000 0x00000002 |
Contrôle dans un état désactivé. Contrôle dans un état activé. Incluez ce bit dans le mot bit dans la colonne Attributs de l'de contrôle pour activer le contrôle lors de la création. Vous pouvez également activer ou désactiver un contrôle à l’aide de la table ControlCondition. |
| 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ôle . |
| 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ôle. Détermine si la propriété associée à ce contrôle est référencée indirectement. |
| entier | 0x00000000 0x00000010 |
La propriété associée au contrôle est une valeur de chaîne. La propriété associée au contrôle est une valeur entière. Incluez ce bit dans le mot bit de la colonne Attributs de la table de contrôle pour définir cet attribut lors de la création du contrôle. |
| RTLRO | 0x00000000 0x00000020 |
Le texte du contrôle s’affiche dans l’ordre de lecture de gauche à droite. Le texte du contrôle s’affiche dans l’ordre de lecture de droite à gauche. |
| aligné à droite | 0x00000000 0x00000040 |
Le texte du contrôle est aligné à gauche. Le texte du contrôle est aligné à droite. |
| leftScroll | 0x00000000 0x00000080 |
La barre de défilement se trouve sur le côté droit du contrôle. La barre de défilement se trouve sur le côté gauche du contrôle. |
| BiDi | 0x000000E0 | Définissez cette valeur pour une combinaison des attributs RTLRO, RightAlignedet LeftScroll. |
| multiligne | 0x00010000 | Crée un contrôle d’édition de ligne multiple avec une barre de défilement verticale. Incluez 65536 dans le mot de bits dans la colonne Attributs du contrôle pour créer un contrôle d’édition de ligne multiple avec une barre de défilement verticale. |
| mot de passe | 0x00200000 | Crée un contrôle de modification pour entrer des mots de passe. Ajoutez 2097152 à la valeur dans la colonne Attributs de la table de contrôle pour créer un contrôle d’édition qui affiche chaque caractère en tant qu’astérisque (*) car ils sont tapés dans le contrôle. La définition de l’attribut mot de passe empêche le programme d’installation d’écrire la propriété associée au contrôle Edit dans le fichier journal. Pour plus d’informations, consultez Empêcher l’écriture d’informations confidentielles dans le fichier journal |
Remarques
Ce contrôle peut être créé à partir de la classe EDIT à l’aide de la fonction CreateWindowEx. Il a les styles WS_BORDER, WS_CHILD, WS_TABSTOPet WS_GROUP.
La longueur du texte qui peut être entrée peut être limitée en plaçant un nombre compris entre 0 et 2147483646 en accolades au début du champ Texte de la table de contrôle . Par exemple, si le champ de texte commence par {80}, la longueur de la chaîne est limitée à 80 caractères. Si aucune telle limite n’est fournie dans la table ou si 0 est spécifiée, la longueur est définie sur la valeur maximale possible (2147483646 caractères). Une valeur négative ou non numérique génère une erreur.
Pour la compatibilité avec les lecteurs d’écran, lors de la création d’une boîte de dialogue avec un contrôle Edit comme premier contrôle actif, vous devez rendre le champ de texte appartenant au champ de modification le premier contrôle actif dans la table dialogue . Étant donné que le texte statique ne peut pas prendre le focus, lorsque la boîte de dialogue est créée, le champ de modification aura le focus initialement comme prévu, mais cela garantit que les lecteurs d’écran affichent les informations correctes.
La propriété associée au contrôle Edit est définie uniquement lorsque le contrôle perd le focus. Par conséquent, vous devez utiliser l’onglet du contrôle ou sélectionner un autre contrôle pour que la propriété soit mise à jour.