Fungsi DlgDirSelectExA (winuser.h)

Artikel
03/04/2024

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