messaggio LB_DIR

Aggiunge nomi all'elenco visualizzato da una casella di riepilogo. Il messaggio aggiunge i nomi delle directory e dei file che corrispondono a una stringa e a un set di attributi di file specificati. LB_DIR può anche aggiungere lettere di unità mappate alla casella di riepilogo.

Parametri

wParam

Attributi dei file o delle directory da aggiungere alla casella di riepilogo. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
DDL_ARCHIVE	Include i file archiviati.
DDL_DIRECTORY	Include sottodirectory. I nomi delle sottodirectory sono racchiusi tra parentesi quadre ([ ]).
DDL_DRIVES	Tutte le unità mappate vengono aggiunte all'elenco. Le unità sono elencate nel formato [-x-], dove x è la lettera di unità.
DDL_EXCLUSIVE	Include solo i file con gli attributi specificati. Per impostazione predefinita, i file di lettura/scrittura vengono elencati anche se non è specificato DDL_READWRITE.
DDL_HIDDEN	Include file nascosti.
DDL_READONLY	Include file di sola lettura.
DDL_READWRITE	Include file di lettura/scrittura senza attributi aggiuntivi. Si tratta dell'impostazione predefinita.
DDL_SYSTEM	Include i file di sistema.

lParam

Puntatore alla stringa con terminazione Null che specifica un percorso assoluto, un percorso relativo o un nome file. Un percorso assoluto può iniziare con una lettera di unità (ad esempio, d:) o un nome UNC ,ad esempio \\ nomecomputer nomeproprietà\ .

Se la stringa specifica un nome file o una directory con gli attributi specificati dal parametro wParam , il nome file o la directory viene aggiunto all'elenco. Se il nome file o la directory contiene caratteri jolly (? o *), tutti i file o le directory che corrispondono all'espressione con caratteri jolly e hanno gli attributi specificati dal parametro wParam vengono aggiunti all'elenco.

Valore restituito

Se il messaggio ha esito positivo, il valore restituito è l'indice in base zero del cognome aggiunto all'elenco.

Se si verifica un errore, il valore restituito viene LB_ERR. Se non è presente spazio sufficiente per archiviare le nuove stringhe, il valore restituito viene LB_ERRSPACE.

Commenti

Il messaggio LB_INITSTORAGE consente di velocizzare l'inizializzazione delle caselle di riepilogo con un numero elevato di elementi (più di 100). Riserva la quantità di memoria specificata in modo che i messaggi successivi LB_DIR impiegano il più breve tempo possibile. È possibile usare stime per i parametri wParam e lParam . Se si sovrastima, la memoria aggiuntiva viene allocata; se si sottovaluta, l'allocazione normale viene usata per gli elementi che superano l'importo richiesto.

Se wParam include il flag DDL_DIRECTORY e lParam specifica tutte le sottodirectory di una directory di primo livello, ad esempio C:\TEMP\*, la casella di riepilogo includerà sempre una voce ".." per la directory radice. Ciò vale anche se la directory radice ha attributi nascosti o di sistema e i flag DDL_HIDDEN e DDL_SYSTEM non sono specificati. La directory radice di un volume NTFS ha attributi nascosti e di sistema.

Nell'elenco vengono visualizzati nomi di file lunghi, se presenti.

Per un'applicazione ANSI, il sistema converte il testo in una casella di riepilogo in Unicode usando CP_ACP. Ciò può causare problemi. Ad esempio, i caratteri romani accentati in una casella di riepilogo non Unicode in Windows giapponese verranno visualizzati in modo accentato. Per risolvere il problema, compilare l'applicazione come Unicode o usare una casella di riepilogo disegnata dal proprietario.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

DlgDirList