Metode IFileDialog::SetFolder (shobjidl_core.h)

Artikel
03/02/2024

Mengatur folder yang selalu dipilih saat dialog dibuka, terlepas dari tindakan pengguna sebelumnya.

Sintaks

HRESULT SetFolder(
  [in] IShellItem *psi
);

Parameter

[in] psi

Jenis: IShellItem*

Penunjuk ke antarmuka yang mewakili folder.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Folder ini mengambil alih folder "yang terakhir digunakan". Jika metode ini dipanggil saat dialog ditampilkan, ini menyebabkan dialog menavigasi ke folder yang ditentukan.

Secara umum, kami tidak merekomendasikan penggunaan metode ini. Jika Anda memanggil SetFolder sebelum menampilkan kotak dialog, lokasi terbaru yang disimpan atau dibuka pengguna tidak ditampilkan. Kecuali ada alasan yang sangat spesifik untuk perilaku ini, itu bukan pengalaman pengguna yang baik atau diharapkan dan karenanya harus dihindari. Dalam hampir semua instans, IFileDialog::SetDefaultFolder adalah metode yang lebih baik.

Pada Windows 7, jika jalur folder yang ditentukan melalui psi adalah jalur default folder yang diketahui, jalur folder yang diketahui saat ini digunakan dalam dialog. Jalur itu mungkin tidak sama dengan jalur yang ditentukan dalam psi; misalnya, jika folder yang diketahui telah dialihkan. Jika folder yang diketahui adalah pustaka (folder virtual Dokumen, Musik, Gambar, dan Video), jalur pustaka digunakan dalam dialog. Jika pustaka yang ditentukan disembunyikan (karena secara default pada Windows 8.1), lokasi penyimpanan default pustaka digunakan dalam dialog, seperti folder Dokumen Microsoft OneDrive untuk pustaka Dokumen. Karena pemetaan ini, lokasi folder yang digunakan dalam dialog mungkin tidak persis seperti yang Anda tentukan ketika Anda memanggil metode ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Bagikan melalui