Contrôle ListView
Contrôle ListView qui affiche une seule colonne de valeurs avec une icône en regard de chaque élément. Elle permet à l’utilisateur de sélectionner une valeur de chaîne ou d’entier unique pour une propriété à partir d’une liste prédéterminée. Les valeurs possibles sont lues à partir de la table ListView. Vous pouvez associer le contrôle à un entier ou une valeur de chaîne en entrant le nom de la propriété dans la colonne propriété de la table de contrôle.
Le contenu du champ de texte de la table de contrôle n’est jamais affiché par le contrôle ListView. Au lieu de cela, ce champ spécifie le style de texte à afficher par le contrôle et contient une description du contrôle utilisé par les utilitaires de révision d’écran. Pour définir la police et le style de police d’une chaîne de texte, ajoutez le préfixe { \ style} ou {&style} à la chaîne de caractères affichés. Où style est un identificateur figurant dans la colonne TextStyle de la table TextStyle. Si aucun de ces deux n’est présent, mais que la propriété DefaultUIFont est définie comme un style de texte valide, cette police sera utilisée. Les informations suivantes sont lues par les utilitaires de révision d’écran comme description du contrôle. Consultez accessibilité.
Attributs du 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 le contrôle à un ControlEvent, dans la table EventMapping et répertoriez l’identificateur de l’attribut dans la colonne d’attribut. Entrez l’identificateur du ControlEvent, dans la colonne d’é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é figurant 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 la largeur, la hauteur, le X et les colonnes Y de la table de contrôle. Utilisez les 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 de IndirectPropertyName. Si l’attribut change, le contrôle reflète la nouvelle valeur. | |
| Text | Pour afficher du texte dans les lecteurs d’écran, entrez le texte dans la colonne de texte de la table de contrôle. Consultez accessibilité. | |
| Visible | 0x00000000 0x00000001 |
Contrôle masqué. Contrôle visible. Incluez ce bit dans le mot de bits de la colonne d’attributs dans 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 de bits dans la colonne attributs du 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 enfoncée, 3D et un look. 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 a l’identificateur figurant 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. |
| Integer | 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 de bits de la colonne d’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 est affiché dans l’ordre de lecture de gauche à droite. Le texte du contrôle est affiché dans l’ordre de lecture de droite à gauche. |
| RightAligned | 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 . |
| Triées | 0x00000000 0x00010000 |
Éléments affichés par ordre alphabétique. Éléments affichés dans l’ordre spécifié dans le tableau ListView. Incluez ce bit dans le mot de bits de la colonne attributs pour afficher les éléments dans l’ordre spécifié par la colonne Order du tableau ListView. |
| FixedSize | 0x00000000 0x00100000 |
Étire l’image d’icône pour l’ajuster au contrôle. Rogne ou centre l’image d’icône dans le contrôle. Incluez ce bit dans le mot de bits de la colonne d’attributs de la table de contrôle. |
| Icône de | 0x00000000 0x00200000 0x00400000 0x00600000 |
Charge la première image. Charge la première image de 16x16. Charge la première image 32 x 32. Charge la première image 48. Un fichier icône peut contenir différentes images de taille de la même icône. Incluez la valeur du mot de bits approprié dans la colonne attributs de la table de contrôle . Si ces bits ne sont pas définis, le programme d’installation ignore l’attribut FixedSize et l’image est étirée pour s’ajuster au rectangle de contrôle. Si les bits d’icône et les bits FixedSize sont tous les deux définis, une image plus petite que le contrôle est centrée et une image est plus grande que le contrôle qu’elle doit ajuster. |
Notes
Ce contrôle peut être créé à partir de la _ classe WC ListView à l’aide de la fonction CreateWindowEx . Il possède les styles _ LVS, LVS _ NOCOLUMNHEADER, WS _ VSCROLL, WS _ HSCROLL, LVS _ SHAREIMAGELISTS, LVS _ SINGLESEL, LVS _ SHOWSELALWAYS, WS _ Border et WS _ TABSTOP . Si le bit de style trié n’est pas activé, le contrôle a également le style LVS _ SORTASCENDING .
Pour la compatibilité avec les lecteurs d’écran, lors de la création d’une boîte de dialogue avec un contrôle ListView comme premier contrôle actif, vous devez faire en sorte que le champ de texte appartenant au champ d’édition soit le premier contrôle actif de la table de boîtes de dialogue. Étant donné que le texte statique ne peut pas prendre le focus, lorsque la boîte de dialogue est créée, le champ d’édition a le focus initialement comme prévu, mais cela permet de s’assurer que les lecteurs d’écran affichent les informations correctes.