Fungsi DlgDirSelectExA (winuser.h)
Mengambil pilihan saat ini dari kotak daftar pilihan tunggal. Ini mengasumsikan bahwa kotak daftar telah diisi oleh fungsi DlgDirList dan bahwa pilihannya adalah huruf drive, nama file, atau nama direktori.
Sintaks
BOOL DlgDirSelectExA(
[in] HWND hwndDlg,
[out] LPSTR lpString,
[in] int chCount,
[in] int idListBox
);
Parameter
[in] hwndDlg
Jenis: HWND
Handel ke kotak dialog yang berisi kotak daftar.
[out] lpString
Jenis: LPTSTR
Penunjuk ke buffer yang menerima jalur yang dipilih.
[in] chCount
Jenis: int
Panjangnya, dalam TCHAR, dari buffer diacu oleh lpString.
[in] idListBox
Jenis: int
Pengidentifikasi kotak daftar dalam kotak dialog.
Nilai kembali
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
Fungsi DlgDirSelectEx menyalin pilihan ke buffer yang diacu oleh parameter lpString . Jika pilihan saat ini adalah nama direktori atau huruf kandar, DlgDirSelectEx menghapus tanda kurung siku penutup (dan tanda hubung, untuk huruf kandar), sehingga nama atau huruf siap dimasukkan ke jalur baru. Jika tidak ada pilihan, lpString tidak berubah.
Jika string panjang atau lebih panjang dari buffer, buffer akan berisi string terpotok dengan karakter null yang mengakhiri.
DlgDirSelectEx mengirim LB_GETCURSEL dan LB_GETTEXT pesan ke kotak daftar. Fungsi ini tidak memperbolehkan lebih dari satu nama file dikembalikan dari kotak daftar. Kotak daftar tidak boleh berupa kotak daftar pilihan ganda. Jika ya, fungsi ini tidak mengembalikan nilai nol dan lpString tetap tidak berubah.
Windows 95 atau yang lebih baru: DlgDirSelectExW didukung oleh Lapisan Microsoft untuk Unicode. 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.
Contoh
Misalnya, lihat Membuat Daftar Direktori di Kotak Daftar Pilihan tunggal.
Catatan
Header winuser.h mendefinisikan DlgDirSelectEx 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