Fungsi DlgDirSelectExA (winuser.h)

Artikel
11/20/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.

Sintaksis

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 yang ditunjukkan oleh lpString.

[in] idListBox

Jenis: int

Pengidentifikasi kotak daftar 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, panggil GetLastError.

Komentar

Fungsi DlgDirSelectEx menyalin pilihan ke buffer yang ditunjukkan 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 selama atau lebih lama dari buffer, buffer akan berisi string terpotong dengan karakter null yang mengakhiri.

DlgDirSelectEx mengirim pesan LB_GETCURSEL dan LB_GETTEXT ke kotak daftar. Fungsi ini tidak memperbolehkan lebih dari satu nama file dikembalikan dari kotak daftar. Kotak daftar tidak boleh berupa kotak daftar beberapa pilihan. 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 for Unicode pada Sistem Windows Me/98/95.

Contoh

Misalnya, lihat Membuat Daftar Direktori dalam Kotak Daftar pilihan tunggal.

Nota

Header winuser.h mendefinisikan DlgDirSelectEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll