Partager via


Contrôle ListView

Contrôle ListView qui affiche une seule colonne de valeurs avec une icône en regard de chaque élément. Il permet à l’utilisateur de sélectionner une chaîne unique ou une valeur entière pour une propriété dans une liste prédéterminée. Les valeurs possibles sont lues à partir de la table ListView. 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 Property de la table Control.

Le contenu du champ Texte de la table Control 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, préfixez de {\style} ou de {&style} la chaîne des caractères affichés Où 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 est utilisée. Les informations suivantes sont lues par les utilitaires de révision d’écran comme description du contrôle. VoirAccessibilité.

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 le 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 Event.

Identificateur d’attribut Bit hexadécimal Description
IndirectPropertyName 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, nom qui constitue également la valeur de la propriété figurant dans la colonne Property de la table Control.
Position Position du contrôle dans la boîte de dialogue. 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 Control. Utilisez les unités du programme d’installation pour la longueur et la distance.
PropertyName   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 Property de la table Control.
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. S’il est défini, il s’agit de la valeur d’IndirectPropertyName. Lorsque l’attribut change, le contrôle reflète la nouvelle valeur.
Texte Pour afficher du texte dans les lecteurs d’écran, entrez le texte dans la colonne Texte de la table Control. VoirAccessibilité.
Visible 0x00000000 0x00000001
Contrôle masqué. Contrôle visible.
Incluez ce bit dans le mot de bit de la colonne Attributes dans la table Control 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 bit dans la colonne Attributes de la table Control 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 un aspect 3D enfoncé.
Incluez ces bits dans le mot bit dans la colonne Attributes de la table Control.
Indirect 0x00000000 0x00000008
Le contrôle affiche ou change la valeur de la propriété dans la colonne Property de la table Control. Le contrôle affiche ou change la valeur de la propriété dont l’identificateur est listé dans la colonne Property de la table Control.
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 d’entier.
Incluez ce bit dans la colonne Attributes de la table Control pour définir cet attribut au moment 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.
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, RightAligned et LeftScroll.
Sorted 0x00000000 0x00010000
Éléments affichés par ordre alphabétique. Éléments affichés dans l’ordre spécifié dans la table ListView.
Incluez ce bit dans le mot de bits dans la colonne Attributs pour afficher les éléments dans l’ordre spécifié par la colonne Order de la table ListView.
FixedSize 0x00000000 0x00100000
Étire l’image d’icône pour s’adapter au contrôle. Rogne ou centre l’image d’icône dans le contrôle.
Incluez ce bit dans la colonne Attributes des tables Control.
iconSize 0x00000000 0x00200000
0x00400000
0x00600000
Charge la première image. Charge la première image 16x16.
Charge la première image 32x32.
Charge la première image 48x48.
Un fichier d’icône peut contenir des images de tailles différentes pour la même icône. Incluez la valeur du mot de bits approprié dans la colonne Attributes de la table Control
Si ces bits ne sont pas définis, le programme d’installation ignore l’attribut FixedSize et l’image sera étirée pour s’adapter au rectangle de contrôle. Si les bits IconSize et FixedSize sont définis, une image plus petite que le contrôle est centrée et une image plus grande que le contrôle qu’elle est réduite à adapter.

 

Notes

Ce contrôle peut être créé à partir de la classe COMBOBOX à l’aide de la fonction CreateWindowEx. Il a les styles LVS_REPORT, 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 du champ de texte appartenant au champ d’édition le premier contrôle actif de la table Dialogue. Étant donné que le texte statique ne peut pas être mis au point, lorsque la boîte de dialogue est créée, le champ de modification a initialement le focus comme prévu, mais cela garantit que les lecteurs d’écran affichent les informations correctes.