CW&nd::DlgDirListnbsp;

int DlgDirList ( LPTSTR lpPathSpec, int nIDListBox, int nIDStaticPath, UINT nFileType );

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario 0.

Parametri

lpPathSpec

Punta 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, vedere la sezione "Osservazioni" seguente.

nIDListBox

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

nIDStaticPath

Specifica l'identificatore del controllo statico di testo utilizzato per visualizzare l'unità corrente e directory. Se nIDStaticPath è 0, DlgDirList presuppone che questo controllo non testo è presente.

nFileType

Specifica gli attributi dei file da visualizzare. Può essere qualsiasi combinazione dei seguenti valori:

• DDL_READWRITE   File di dati di lettura e scrittura con attributi aggiuntivi.
  
  
• DDL_READO&NLYnbsp;  File di sola lettura.
  
  
• DDL_HIDDE&Nnbsp;  File nascosti.
  
  
• DDL_SYSTEM   File di sistema.
  
  
• DDL_DIRECTORY   Telefonici.
  
  
• DDL_ARCHIVE   Archivi.
  
  
• DDL_POSTMSGS LB_DIR bandiera. Se è impostato il flag LB_DIR , Windows inserisce i messaggi generati da DlgDirList in coda dell'applicazione; in caso contrario, essi vengono inviati direttamente alla procedura di dialogo.
  
  
• DDL_DRIVES   Unità. Se è impostato il flag DDL_DRIVES , il flag DDL_EXCLUSIVE viene impostato automaticamente. Pertanto, per creare un elenco di directory che include l'unità e file, è necessario chiamare DlgDirList due volte: una volta, con la DDL_DRIVES bandiera insieme e una volta con le bandiere per il resto della lista.
  
  
• DDL_EXCLUSIVE   Po ' esclusiva. Se viene impostato il bit esclusivo, vengono elencati solo i file del tipo specificato; in caso contrario sono elencati i file normali e del tipo specificato.

Osservazioni

Riempie una casella di riepilogo con un elenco di file o directory. Invia DlgDirList LB_RESETCONTENT e LB_DIR messaggi alla casella di riepilogo. Riempie la casella di riepilogo specificata da nIDListBox con i nomi di tutti i file che corrispondono il percorso dato da lpPathSpec.

Il parametro lpPathSpec ha la seguente forma:

[unità:] [[u]directory[\idirectory]... u] [nome file]

In questo esempio, 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. I caratteri jolly sono un punto interrogativo (?), che significa rispettare qualsiasi carattere e un asterisco, che significa corrispondere qualsiasi numero di caratteri.

Se si specifica una stringa di lunghezza 0 per lpPathSpec, o se si specifica solo un nome di directory, ma non includono qualsiasi specifica del file, la stringa verrà modificata in "*. *".

Se lpPathSpec include un disco e/o nome della directory, l'unità corrente e directory vengono sostituiti con il designato unità e la directory prima casella di riepilogo è pieno. Il controllo di testo identificato da nIDStaticPath viene aggiornato con il nuovo disco e/o il nome della directory.

Dopo la casella di riepilogo è pieno, lpPathSpec viene aggiornato rimuovendo il disco e/o directory di parte del percorso.

Panoramica di CWnd |nbsp; Membri della classe | Gerarchia Chart

Vedere anchenbsp;CWnd::DlgDirListComboBox, :: DlgDirList