DlgDirList

La funzione DlgDirList riempie la casella elenco specificato con i nomi di tutti i file corrispondenti al percorso specificato o nomefile.

int (DlgDirList HWND  hDlg, / / handle di finestra di dialogo con casella di riepilogoLPTSTRlpPathSpec, / / puntatore alla stringa di percorso o nome del fileintnIDListBox, / / identificatore della casella di riepilogointnIDStaticPath, / / identificatore del controllo staticoUINTuFileType / / file attributi per visualizzare);
 

Parametri

hDlg

Handle per la finestra di dialogo che contiene la casella di riepilogo.

lpPathSpec

Puntatore a una stringa con terminazione null che contiene il percorso o il nome del file. DlgDirList modifica questa stringa, che dovrebbe essere abbastanza a lungo per contenere le modifiche. Per ulteriori informazioni su questo parametro, vedere la sezione Osservazioni.

nIDListBox

Specifica l'identificatore di una casella di riepilogo. Se questo parametro è zero, DlgDirList si presuppone che nessuna casella di riepilogo e non tenta di riempire uno.

nIDStaticPath

Specifica l'identificatore del controllo statico utilizzato per la visualizzazione di unità corrente e directory. Se questo parametro è zero, DlgDirList presuppone che questo controllo non è presente.

uFileType

Specifica gli attributi di nomi di file da visualizzare. Questo parametro deve essere uno o più dei seguenti valori:

Valore	Descrizione
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, 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 si specifica una stringa di lunghezza zero per il parametro lpPathSpec o se si specifica solo un nome di directory con nessun nome di file, la stringa verrà modificata in *. *

Il parametro lpPathSpec ha la seguente forma:

[auto:] [[u]directory[\idirectory] \u] [nomefile]

In questo esempio, l'unità è una lettera di unità, directory è un nome di directory valido e filename è un nome di file valido che deve contenere almeno un carattere jolly (? o *).

Se lpPathSpec include un'unità o nome di directory o entrambi, l'unità corrente e directory vengono modificate per l'unità specificata e directory prima casella di riepilogo è pieno. Il controllo statico identificato dal parametro nIDStaticPath viene aggiornato con il nuovo disco o nome della directory o entrambi.

Dopo che la casella di riepilogo è pieno, DlgDirList aggiorna lpPathSpec rimuovendo l'unità o porzione di directory o entrambi, il percorso e il nome del file.

DlgDirList invia i messaggi LB_RESETCONTENT e LB_DIR alla casella di riepilogo.

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

Elenco caselle panoramica, elenco funzioni Box, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

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

Index