DlgDirListComboBox

La funzione DlgDirListComboBox riempie la casella combinata specificato con un elenco di directory. Riempie l'elenco con i nomi di tutti i file, le unità e le sottodirectory che corrispondono gli attributi specificati e la stringa di percorso.

int (DlgDirListComboBox HWND  hDlg, / / handle di finestra di dialogo con casella combinataLPTSTRlpPathSpec, / / puntatore alla stringa di percorso o nome del fileintnIDComboBox, / / identificatore della casella combinataintnIDStaticPath, / / identificatore del controllo staticoUINTuFiletype / / file attributi per visualizzare);
 

Parametri

hDlg
Handle per la finestra di dialogo che contiene la casella combinata.
lpPathSpec
Puntatore a una stringa null-terminated il seguente formato:

[drive:][\]][directory\[...]][nome file]

Se l'oggetto string specificato include un'unità o percorso di directory, la funzione DlgDirListComboBox cambia l'unità corrente e directory prima di riempire la lista. Dopo che l'elenco è pieno, il percorso di unità e la directory vengono rimossi dalla stringa specificata dal parametro lpPathSpec.

nIDComboBox
Specifica l'identificatore di un controllo casella combinata in una finestra di dialogo. Se nIDComboBox è zero, la funzione di DlgDirListComboBox si presuppone alcuna casella combinata e non tenta di riempirlo.
nIDStaticPath
Specifica l'identificatore del controllo di testo statico, in cui la funzione DlgDirListComboBox è quello di visualizzare la directory corrente. Se nIDStaticPath è zero, DlgDirListComboBox si assume che questo controllo non è presente.
uFiletype
Specifica gli attributi dei file da visualizzare. Può essere qualsiasi combinazione dei seguenti valori:
Valore Significato
DDL_ARCHIVE Include file archiviati.
DDL_DIRECTORY Include le sottodirectory. Nomi di sottodirectory sono racchiusi tra parentesi quadre ([]).
DDL_DRIVES Include le unità. Le unità sono elencate nel modulo [-x-], dove x è la lettera dell'unità.
DDL_EXCLUSIVE Include solo i file con gli attributi specificati. Per impostazione predefinita, i file di sola lettura sono elencati anche se non è specificato DDL_READWRITE.
DDL_HIDDEN Include i file nascosti.
DDL_READONLY Include file di sola lettura.
DDL_READWRITE Include file di lettura e scrittura con attributi aggiuntivi.
DDL_SYSTEM Include i file di sistema.
DDL_POSTMSGS I messaggi dei messaggi alla coda di messaggi dell'applicazione. Per impostazione predefinita, la funzione DlgDirList invia messaggi direttamente alla procedura di dialogo casella.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Ad esempio, se la stringa specificata dalla lpPathSpec non è un percorso valido, la funzione non riesce. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Se il parametro lpszPathSpec punta a una stringa di lunghezza zero o a una stringa che specifica un'unità, directory o entrambi — ma nessun nome file — il nome del file *. * presuppone (jolly).

Windows NT:
Elenco di directory consente di visualizzare i nomi di file lunghi, se qualsiasi.
Windows 95:
Elenco di directory vengono visualizzati i nomi di file breve (la forma 8.3). È possibile utilizzare le funzioni SHGetFileInfo o GetFullPathName per ottenere il corrispondente nome file lungo.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Combo Boxes Overview, funzioni di una casella combinata, DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index