CDM_GETFILEPATH pesan

[Dimulai dengan Windows Vista, kotak dialog Buka dan Simpan Sebagai umum telah digantikan oleh Dialog Item Umum. Kami menyarankan agar Anda menggunakan API Dialog Item Umum alih-alih kotak dialog ini dari Pustaka Kotak Dialog Umum.]

Mengambil jalur dan nama file file yang dipilih dalam kotak dialog Buka atau Simpan Sebagai gaya Penjelajah. Kotak dialog harus dibuat dengan bendera OFN_EXPLORER ; jika tidak, pesan gagal.

#define WM_USER                  0x0400
#define CDM_FIRST               (WM_USER + 100)
#define CDM_GETFILEPATH         (CDM_FIRST + 0x0001)

Parameter

wParam

Ukuran, dalam karakter, dari buffer lParam . Untuk versi ANSI, ini adalah jumlah byte; untuk versi Unicode, ini adalah jumlah karakter.

lParam

Penunjuk ke buffer yang menerima nama dan jalur file.

Nilai kembali

Jika pesan berhasil, nilai yang dikembalikan adalah ukuran, dalam karakter, dari nama file dan string jalur, termasuk karakter NULL yang mengakhiri. Ini adalah jumlah byte atau karakter yang disalin ke buffer, atau ukuran buffer yang diperlukan jika buffer terlalu kecil.

Jika terjadi kesalahan, nilai yang dikembalikan kurang dari nol.

Keterangan

Makro yang sesuai adalah sebagai berikut:

int CommDlg_OpenSave_GetFilePath(hwnd, lparam, wparam); 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung
Windows 2000 Server [hanya aplikasi desktop]
Header
Commdlg.h (sertakan Windows.h)

Lihat juga

Referensi

GetOpenFileName

GetSaveFileName

OPENFILENAME

Konseptual

Pustaka Kotak Dialog Umum