ListBox, contrôle
Le contrôle ListBox est une zone de liste classique qui permet à l’utilisateur d’effectuer une seule sélection parmi une liste de valeurs prédéterminées. Les valeurs possibles sont lues à partir de la table Listbox. Vous pouvez associer une propriété de chaîne ou d’entier en entrant le nom de la propriété dans la colonne Property de la table Control.
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 | Texte affiché par les lecteurs d’écran. Entrez le texte à afficher dans la colonne Text de la table Control. Pour définir la police et le style de police d’une chaîne de caractères, faites précéder la chaîne des caractères affichés de {\style} ou {&style}. 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. |
|
| 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 la colonne Attributes pour afficher les éléments dans l’ordre spécifié par la colonne Order de la table ListView. |
| UsersLanguage | 0x00000000 0x00100000 |
Polices créées dans la page de codes de la base de données. Polices créées dans la page de codes d’IU par défaut de l’utilisateur. |
Notes
Vous pouvez créer ce contrôle à partir de la classe LISTBOX en utilisant la fonction CreateWindowEx. Il comporte les styles WS_TABSTOP, WS_GROUP et WS_CHILD. Si le bit de style du contrôle Sorted est activé, le contrôle est créé avec les styles LBS_NOTIFY, WS_VSCROLL et WS_BORDER. Sinon, le contrôle est créé avec le style LBS_STANDARD.