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 |
|
Vedi anche
-
Riferimento