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