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
Referensi
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk