CWnd::DlgDirList

Articolo
02/19/2013

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);