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