Fungsi DlgDirSelectComboBoxExA (winuser.h)

Mengambil pilihan saat ini dari kotak kombo yang diisi dengan menggunakan fungsi DlgDirListComboBox . Pilihan ditafsirkan sebagai huruf kandar, file, atau nama direktori.

Sintaks

BOOL DlgDirSelectComboBoxExA(
  [in]  HWND  hwndDlg,
  [out] LPSTR lpString,
  [in]  int   cchOut,
  [in]  int   idComboBox
);

Parameter

[in] hwndDlg

Jenis: HWND

Handel ke kotak dialog yang berisi kotak kombo.

[out] lpString

Jenis: LPTSTR

Penunjuk ke buffer yang menerima jalur yang dipilih.

[in] cchOut

Jenis: int

Panjang, dalam karakter, dari buffer yang diacu oleh parameter lpString .

[in] idComboBox

Jenis: int

Pengidentifikasi bilangan bulat kontrol kotak kombo dalam kotak dialog.

Mengembalikan nilai

Jenis: BOOL

Jika pilihan saat ini adalah nama direktori, nilai yang dikembalikan bukan nol.

Jika pilihan saat ini bukan nama direktori, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika pilihan saat ini menentukan nama direktori atau huruf kandar, fungsi DlgDirSelectComboBoxEx menghapus tanda kurung siku penutup (dan tanda hubung untuk huruf drive) sehingga nama atau huruf siap dimasukkan ke dalam jalur atau nama file baru. Jika tidak ada pilihan, konten buffer yang diacu oleh lpString tidak berubah.

Fungsi DlgDirSelectComboBoxEx tidak mengizinkan lebih dari satu nama file dikembalikan dari kotak kombo.

Jika string panjang atau lebih panjang dari buffer, buffer berisi string terpotok dengan karakter null yang mengakhiri.

DlgDirSelectComboBoxEx mengirim pesan CB_GETCURSEL dan CB_GETLBTEXT ke kotak kombo.

Anda dapat menggunakan fungsi ini dengan ketiga jenis kotak kombo (CBS_SIMPLE, CBS_DROPDOWN, dan CBS_DROPDOWNLIST).

Peringatan Keamanan: Penggunaan fungsi ini yang tidak tepat dapat menyebabkan masalah bagi aplikasi Anda. Misalnya, parameter nCount harus diatur dengan benar untuk versi ANSI dan Unicode. Kegagalan untuk melakukannya dapat menyebabkan luapan buffer. Anda harus meninjau Pertimbangan Keamanan: Kontrol Microsoft Windows sebelum melanjutkan.

Windows 95 atau yang lebih baru: DlgDirSelectComboBoxExW didukung oleh Microsoft Layer for Unicode (MSLU). Untuk menggunakan ini, Anda harus menambahkan file tertentu ke aplikasi Anda, seperti yang diuraikan dalam Microsoft Layer untuk Unicode pada Sistem Windows Me/98/95.

Catatan

Header winuser.h mendefinisikan DlgDirSelectComboBoxEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Lihat juga

CB_GETCURSEL

CB_GETLBTEXT

DlgDirListComboBox

Referensi