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