pesan CB_DIR
Menambahkan nama ke daftar yang ditampilkan oleh kotak kombo. Pesan menambahkan nama direktori dan file yang cocok dengan string dan set atribut file tertentu. CB_DIR juga dapat menambahkan huruf kandar yang dipetakan ke daftar.
Parameter
-
wParam
-
Atribut file atau direktori yang akan ditambahkan ke kotak kombo. Parameter ini bisa menjadi satu atau beberapa nilai berikut.
Nilai Makna - DDL_ARCHIVE
Termasuk file yang diarsipkan. - DDL_DIRECTORY
Termasuk subdirektori, yang 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
Menyertakan file tersembunyi. - DDL_READONLY
Menyertakan file baca-saja. - DDL_READWRITE
Termasuk file baca/tulis tanpa atribut tambahan. Ini adalah default. - DDL_SYSTEM
Termasuk file sistem. -
lParam
-
Penunjuk LPCTSTR ke string yang dihentikan null yang menentukan jalur absolut, jalur relatif, atau nama file. Jalur absolut dapat dimulai dengan huruf kandar (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 yang ditampilkan dalam kotak kombo.
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 adalah CB_ERR. Jika tidak ada cukup ruang untuk menyimpan string baru, nilai yang dikembalikan adalah CB_ERRSPACE.
Keterangan
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 berlaku bahkan jika 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.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
| Header |
|
Lihat juga
-
Referensi