Metode IFileDialogEvents::OnFolderChanging (shobjidl_core.h)

Artikel
03/15/2023

Dipanggil sebelum IFileDialogEvents::OnFolderChange. Ini memungkinkan pelaksana untuk menghentikan navigasi ke lokasi tertentu.

Sintaks

HRESULT OnFolderChanging(
  [in] IFileDialog *pfd,
  [in] IShellItem  *psiFolder
);

Parameter

[in] pfd

Jenis: IFileDialog*

Penunjuk ke antarmuka yang mewakili dialog.

[in] psiFolder

Jenis: IShellItem*

Penunjuk ke antarmuka yang mewakili folder tempat dialog akan dinavigasi.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya. Nilai pengembalian S_OK atau E_NOTIMPL menunjukkan bahwa perubahan folder dapat dilanjutkan.

Keterangan

Aplikasi panggilan dapat memanggil IFileDialog::SetFolder selama panggilan balik ini untuk mengalihkan navigasi ke folder alternatif. Navigasi aktual tidak terjadi sampai IFileDialogEvents::OnFolderChanging telah kembali.

Jika aplikasi panggilan hanya mencegah navigasi ke folder tertentu, UI harus ditampilkan dengan penjelasan tentang pembatasan. Untuk mendapatkan HWND induk untuk UI, dapatkan antarmuka IOleWindow melalui IFileDialog dan panggil IOleWindow::GetWindow.

Persyaratan


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