CWnd::DlgDirList
Inserisce una casella di riepilogo di file o della directory.
int DlgDirList(
LPTSTR lpPathSpec,
int nIDListBox,
int nIDStaticPath,
UINT nFileType
);
Parametri
lpPathSpec
Punta a una stringa con terminazione null che contiene il percorso o il nome file. DlgDirList modifica questa stringa, che deve essere sufficientemente lungo di contenere le modifiche. Per ulteriori informazioni, vedere la sezione "note".nIDListBox
Specifica l'identificatore di una casella di riepilogo. Se nIDListBox è 0, DlgDirList presuppone che nessuna casella di riepilogo esista e non tentare di riempire uno.nIDStaticPath
Specifica l'identificatore del controllo del elettricità- testo utilizzato per visualizzare l'unità e la directory corrente. Se nIDStaticPath è 0, DlgDirList presuppone che non vi sia tale controllo di testo presente.nFileType
Specifica gli attributi di file da visualizzare. Può essere qualsiasi combinazione dei valori seguenti:File di dati di lettura e scrittura diDDL_READWRITE senza attributi aggiuntivi.
File di sola lettura diDDL_READONLY.
File nascostiDDL_HIDDEN.
File di sistemaDDL_SYSTEM.
Directory diDDL_DIRECTORY.
File diDDL_ARCHIVE.
DDL_POSTMSGS Flag diLB_DIR. Se il flag LB_DIR è impostato, Windows posiziona i messaggi generati da DlgDirList nella coda dell'applicazione; in caso contrario, vengono inviati direttamente alla routine della finestra di dialogo.
Unità diDDL_DRIVES. Se il flag DDL_DRIVES è impostato, il flag DDL_EXCLUSIVE viene impostato automaticamente. Di conseguenza, per creare una visualizzazione directory che include unità e i file, è necessario chiamare due volte DlgDirList : una volta con il flag DDL_DRIVES e una volta con flag per il resto dell'elenco.
Bit esclusivo diDDL_EXCLUSIVE. Se il bit esclusivo è impostato, solo i file del tipo specificato sono elencati, gli altri file diretti e i file del tipo specificato sono elencati.
Valore restituito
Diverso da zero se la funzione ha esito positivo; in caso contrario 0.
Note
DlgDirList invia i messaggi LB_DIR e LB_RESETCONTENT alla casella di riepilogo. Riempie la casella di riepilogo specificata da nIDListBox di nomi di tutti i file che corrispondono al percorso specificato da lpPathSpec.
Il parametro lpPathSpec ha il formato seguente:
[drive:] [ [\u]directory[\idirectory]... \u] [filename]
In questo esempio, drive è una lettera di unità, directory è un nome di directory valido e il nome file è un nome di file valido che deve contenere almeno un carattere jolly. I caratteri jolly in un punto interrogativo (?), ovvero la corrispondenza di qualsiasi carattere e un asterisco (*), significante la corrispondenza qualsiasi numero di caratteri.
Se si specificano le 0 stringhe di lunghezza per lpPathSpec, o se si specifica solo un nome di directory ma non include alcuna specifica di file, la stringa verrà modificata "a" *.*.
Se lpPathSpec include un'unità e/o un nome di directory, unità e la directory corrente vengono modificate nell'unità e la directory specificate prima che la casella di riepilogo sia completata. Il controllo testo identificato da nIDStaticPath viene aggiornato con la nuova unità e/o nome della directory.
Dopo che la casella di riepilogo viene soddisfatta, lpPathSpec viene aggiornato rimuovendo la parte della directory e/o di unità percorso.
Esempio
// If pDialog points to a CDialog object with a list box
// with the identifier IDC_DIRLIST, this call will populate
// the box with only the non-hidden subdirectories in the root
// directory of the C:\ drive.
TCHAR path[MAX_PATH];
_tcscpy_s(path, MAX_PATH, _T("C:\\"));
pDialog->DlgDirList(path, IDC_DIRLIST, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);
Requisiti
Header: afxwin.h