Contrôle DirectoryList
Un contrôle DirectoryList permet de visualiser une partie du chemin actuellement affiché dans le contrôle PathEdit. Il présente les dossiers figurant sous le répertoire rendu visible par le contrôle DirectoryCombo.
Les contrôles PathEdit, DirectoryCombo et DirectoryList sont associés à la même propriété à valeur de chaîne. Cette propriété correspond au chemin sélectionné par l’utilisateur. Entrez le nom de la propriété dans la colonne Property de la table Control. Cette propriété doit posséder une valeur initiale contenant au moins un volume et un sous-niveau. Spécifiez sa valeur initiale dans la colonne Value de la table Property.
Ce contrôle est destiné à être utilisé dans une boîte de dialogue Parcourir avec les contrôles PathEdit et DirectoryList.
Le contrôle DirectoryList publie les événements ControlEvent suivants.
| ControlEvent | Description |
|---|---|
| DirectoryListNew | Crée un dossier et sélectionne le champ de nom à modifier. |
| IgnoreChange | Met en surbrillance (mais n’ouvre pas) un dossier dans le répertoire actif. |
| DirectoryListUp | Sélectionne le parent du répertoire présent. |
| DirectoryListOpen | Sélectionne et met en surbrillance un répertoire. |
Le contenu du champ Text de la table Control n’est jamais affiché par le contrôle DirectoryList. Ce champ spécifie en revanche le style de texte que le contrôle doit présenter. Il contient une description du contrôle utilisé par les utilitaires de consultation 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 bit dans la colonne Attributes de la table Control pour rendre le contrôle visible ou masqué lors de sa création. Il est également possible de masquer ou d’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 sous un aspect 3D enfoncé. Incluez ces bits dans le mot bit dans la colonne Attributes de la table Control. |
| Indirect | 0x00000000 0x00000008 |
Affiche ou modifie la valeur de la propriété dans la colonne Property de la table Control. Affiche ou modifie la valeur de la propriété dont l’identificateur figure dans la colonne Property de la table Control. Détermine s’il existe une référence indirecte à la propriété associée à ce 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 Control | 0x000000E0 | Définissez cette valeur pour une combinaison des attributs RTLRO, RightAligned et LeftScroll. |
Notes
Ce contrôle peut être créé à partir de la classe WC_LISTVIEW, à l’aide de la fonction CreateWindowEx. Il comporte les styles LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUP et WS_TABSTOP.
Ce contrôle permet à l’utilisateur de sélectionner un sous-dossier de la sélection actuelle. Il rend également possible, avec des boutons supplémentaires, de sélectionner un nouveau dossier dans la sélection actuelle ou de monter d’un niveau dans le chemin. Si l’utilisateur choisit le bouton Créer un dossier dans un dossier dans lequel il existe déjà un nouveau dossier, il n’est pas créé de deuxième dossier. Le nom du nouveau dossier existant est sélectionné pour modification.