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
Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

CB_ADDSTRING

CB_INSERTSTRING

DlgDirListComboBox