LB_DIR pesan

Menambahkan nama ke daftar yang ditampilkan oleh kotak daftar. Pesan menambahkan nama direktori dan file yang cocok dengan string dan set atribut file tertentu. LB_DIR juga dapat menambahkan huruf kandar yang dipetakan ke kotak daftar.

Parameter

wParam

Atribut file atau direktori yang akan ditambahkan ke kotak daftar. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
DDL_ARCHIVE	Termasuk file yang diarsipkan.
DDL_DIRECTORY	Termasuk subdirektori. Nama subdirektori diapit dalam tanda kurung siku ([ ]).
DDL_DRIVES	Semua drive yang dipetakan ditambahkan ke daftar. Drive tercantum dalam formulir [-x-], di mana x adalah huruf kandar.
DDL_EXCLUSIVE	Hanya menyertakan file dengan atribut yang ditentukan. Secara default, file baca/tulis dicantumkan meskipun DDL_READWRITE tidak ditentukan.
DDL_HIDDEN	Termasuk file tersembunyi.
DDL_READONLY	Menyertakan file baca-saja.
DDL_READWRITE	Termasuk file baca/tulis tanpa atribut tambahan. Ini adalah pengaturan default.
DDL_SYSTEM	Termasuk file sistem.

lParam

Penunjuk ke string yang dihentikan null yang menentukan jalur absolut, jalur relatif, atau nama file. Jalur absolut dapat dimulai dengan huruf drive (misalnya, d:) atau nama UNC (misalnya, \\ machinename\ sharename).

Jika string menentukan nama file atau direktori yang memiliki atribut yang ditentukan oleh parameter wParam , nama file atau direktori ditambahkan ke daftar. Jika nama file atau nama direktori berisi karakter kartubebas (? atau *), semua file atau direktori yang cocok dengan ekspresi kartubebas dan memiliki atribut yang ditentukan oleh parameter wParam ditambahkan ke daftar.

Menampilkan nilai

Jika pesan berhasil, nilai yang dikembalikan adalah indeks berbasis nol dari nama belakang yang ditambahkan ke daftar.

Jika terjadi kesalahan, nilai yang dikembalikan LB_ERR. Jika tidak ada cukup ruang untuk menyimpan string baru, nilai yang dikembalikan LB_ERRSPACE.

Keterangan

Pesan LB_INITSTORAGE membantu mempercepat inisialisasi kotak daftar yang memiliki sejumlah besar item (lebih dari 100). Ini mencadangkan jumlah memori yang ditentukan sehingga pesan LB_DIR berikutnya membutuhkan waktu sesingkat mungkin. Anda dapat menggunakan perkiraan untuk parameter wParam dan lParam . Jika Anda terlalu berlebihan, memori tambahan dialokasikan; jika Anda meremehkan, alokasi normal digunakan untuk item yang melebihi jumlah yang diminta.

Jika wParam menyertakan bendera DDL_DIRECTORY dan lParam menentukan semua subdirektori direktori tingkat pertama, seperti C:\TEMP\*, kotak daftar akan selalu menyertakan entri ".." untuk direktori akar. Ini benar meskipun direktori akar memiliki atribut tersembunyi atau sistem dan bendera DDL_HIDDEN dan DDL_SYSTEM tidak ditentukan. Direktori akar volume NTFS memiliki atribut tersembunyi dan sistem.

Daftar menampilkan nama file panjang, jika ada.

Untuk aplikasi ANSI, sistem mengonversi teks dalam kotak daftar ke Unicode menggunakan CP_ACP. Hal ini dapat menyebabkan masalah. Misalnya, karakter Romawi beraksen dalam kotak daftar non-Unicode di Windows Jepang akan keluar kacau. Untuk memperbaikinya, kompilasi aplikasi sebagai Unicode atau gunakan kotak daftar yang digambar pemilik.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h)

Lihat juga

DlgDirList