messaggio CB_DIR

Aggiunge nomi all'elenco visualizzato dalla casella combinata. Il messaggio aggiunge i nomi delle directory e dei file che corrispondono a una stringa e a un set di attributi di file specificati. CB_DIR può anche aggiungere lettere di unità mappate all'elenco.

Parametri

wParam

Attributi dei file o delle directory da aggiungere alla casella combinata. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
DDL_ARCHIVE	Include i file archiviati.
DDL_DIRECTORY	Include sottodirectory, racchiuse tra parentesi quadre ([ ]).
DDL_DRIVES	Tutte le unità mappate vengono aggiunte all'elenco. Le unità sono elencate nel formato [-x-], dove x è la lettera di unità.
DDL_EXCLUSIVE	Include solo i file con gli attributi specificati. Per impostazione predefinita, i file di lettura/scrittura vengono elencati anche se non è specificato DDL_READWRITE.
DDL_HIDDEN	Include file nascosti.
DDL_READONLY	Include file di sola lettura.
DDL_READWRITE	Include file di lettura/scrittura senza attributi aggiuntivi. Questo è il valore predefinito.
DDL_SYSTEM	Include i file di sistema.

lParam

Puntatore LPCTSTR a una stringa con terminazione Null che specifica un percorso assoluto, un percorso relativo o un nome file. Un percorso assoluto può iniziare con una lettera di unità (ad esempio, d:) o un nome UNC (ad esempio, \\nomecomputeronome \condiviso). Se la stringa specifica un nome file o una directory con gli attributi specificati dal parametro wParam , il nome file o la directory viene aggiunto all'elenco. Se il nome file o il nome della directory contiene caratteri jolly (? o *), tutti i file o le directory che corrispondono all'espressione con caratteri jolly e hanno gli attributi specificati dal parametro wParam vengono aggiunti all'elenco visualizzato nella casella combinata.

Valore restituito

Se il messaggio ha esito positivo, il valore restituito è l'indice in base zero del cognome aggiunto all'elenco.

Se si verifica un errore, il valore restituito viene CB_ERR. Se non è presente spazio sufficiente per archiviare le nuove stringhe, il valore restituito è CB_ERRSPACE.

Commenti

Se wParam include il flag DDL_DIRECTORY e lParam specifica tutte le sottodirectory di una directory di primo livello, ad esempio C:\TEMP\*, la casella di riepilogo includerà sempre una voce ".." per la directory radice. Ciò vale anche se la directory radice ha attributi nascosti o di sistema e i flag DDL_HIDDEN e DDL_SYSTEM non sono specificati. La directory radice di un volume NTFS ha attributi nascosti e di sistema.

Nell'elenco vengono visualizzati nomi di file lunghi, se presenti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

Riferimento

CB_ADDSTRING

CB_INSERTSTRING

DlgDirListComboBox