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