CB_DIR message
Ajoute des noms à la liste affichée par la zone de liste déroulante. Le message ajoute les noms des répertoires et des fichiers qui correspondent à une chaîne et à un ensemble d’attributs de fichier spécifiés. CB_DIR pouvez également ajouter des lettres de lecteur mappées à la liste.
Paramètres
-
wParam
-
Attributs des fichiers ou répertoires à ajouter à la zone de liste déroulante. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.
Valeur Signification - DDL_ARCHIVE
Inclut les fichiers archivés. - DDL_DIRECTORY
Inclut les sous-répertoires, qui sont placés entre crochets ([ ]). - DDL_DRIVES
Tous les lecteurs mappés sont ajoutés à la liste. Les lecteurs sont répertoriés sous la forme [-x-], où x est la lettre de lecteur. - DDL_EXCLUSIVE
Inclut uniquement les fichiers avec les attributs spécifiés. Par défaut, les fichiers en lecture/écriture sont répertoriés même si DDL_READWRITE n’est pas spécifié. - DDL_HIDDEN
Inclut les fichiers masqués. - DDL_READONLY
Inclut des fichiers en lecture seule. - DDL_READWRITE
Inclut des fichiers en lecture/écriture sans attributs supplémentaires. Il s’agit de la valeur par défaut. - DDL_SYSTEM
Inclut les fichiers système. -
lParam
-
Pointeur LPCTSTR vers une chaîne terminée par null qui spécifie un chemin d’accès absolu, un chemin relatif ou un nom de fichier. Un chemin d’accès absolu peut commencer par une lettre de lecteur (par exemple, d:) ou un nom UNC (par exemple, \\nom_machine nom\_partage). Si la chaîne spécifie un nom de fichier ou un répertoire qui a les attributs spécifiés par le paramètre wParam , le nom de fichier ou le répertoire est ajouté à la liste. Si le nom de fichier ou le nom du répertoire contient des caractères génériques (? ou *), tous les fichiers ou répertoires qui correspondent à l’expression générique et dont les attributs sont spécifiés par le paramètre wParam sont ajoutés à la liste affichée dans la zone de liste déroulante.
Valeur retournée
Si le message réussit, la valeur de retour est l’index de base zéro du nom ajouté à la liste.
Si une erreur se produit, la valeur de retour est CB_ERR. S’il n’y a pas suffisamment d’espace pour stocker les nouvelles chaînes, la valeur de retour est CB_ERRSPACE.
Notes
Si wParam inclut l’indicateur DDL_DIRECTORY et si lParam spécifie tous les sous-répertoires d’un répertoire de premier niveau, tel que C:\TEMP\*, la zone de liste inclut toujours une entrée « ». pour le répertoire racine. Cela est vrai même si le répertoire racine a des attributs masqués ou système et que les indicateurs DDL_HIDDEN et DDL_SYSTEM ne sont pas spécifiés. Le répertoire racine d’un volume NTFS a des attributs masqués et système.
La liste affiche les noms de fichiers longs, le cas échéant.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| En-tête |
|
Voir aussi
-
Référence