Contrôle DirectoryList
Un contrôle DirectoryList affiche une partie du chemin d’accès actuellement affiché dans le contrôle PathEdit. Le contrôle DirectoryList affiche les dossiers sous le répertoire actuellement affiché par le contrôle DirectoryCombo.
Les contrôles PathEdit, DirectoryCombo et DirectoryList sont associés à la même propriété de chaîne. Cette propriété est le chemin d’accès sélectionné par l’utilisateur. Entrez le nom de la propriété dans la colonne Propriété de la table de contrôle . Cette propriété doit avoir une valeur initiale contenant au moins un volume et un sous-niveau. Spécifiez la valeur initiale de la propriété dans la colonne Valeur de la table Property.
Ce contrôle est destiné à être utilisé sur un Parcourir la boîte de dialogue avec le contrôle PathEdit et DirectoryList.
Le contrôle DirectoryList publie les événements ControlEvents suivants.
| ControlEvent | Description |
|---|---|
| DirectoryListNew | Crée un dossier et sélectionne le champ de nom à modifier. |
| IgnoreChange | Met en surbrillance, mais ne s’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 Texte de la table de contrôle n’est jamais affiché par le contrôle DirectoryList. 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 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. Les informations suivantes sont lues par les utilitaires de révision d’écran comme description du contrôle. Consultez d’accessibilité.
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 afficher du texte dans les lecteurs d’écran, entrez le texte dans la colonne Texte du tableau de contrôle . Consultez d’accessibilité. | |
| 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. |
| 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. |
| de contrôle BiDi | 0x000000E0 | Définissez cette valeur pour une combinaison des attributs RTLRO, RightAlignedet LeftScroll. |
Remarques
Ce contrôle peut être créé à partir de la classe WC_LISTVIEW à l’aide de la fonctionCreateWindowEx. Il a les styles LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUPet WS_TABSTOP.
Ce contrôle permet à l’utilisateur de sélectionner un sous-dossier de la sélection actuelle. Avec des boutons supplémentaires, il permet également à l’utilisateur de sélectionner un nouveau dossier dans la sélection actuelle ou de monter un niveau dans le chemin d’accès. Si l’utilisateur choisit le bouton Créer un dossier dans un dossier où un nouveau dossier existe déjà, un deuxième dossier n’est pas créé et le nom du dossier existant est sélectionné pour modification.