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	Winuser.h (inclure Windows.h)

Voir aussi

Référence

CB_ADDSTRING

CB_INSERTSTRING

DlgDirListComboBox