IFileDialogEvents::OnFolderChanging-Methode (shobjidl_core.h)

Artikel
08/26/2023

Wird vor IFileDialogEvents::OnFolderChange aufgerufen. Dadurch kann der Implementierer die Navigation zu einem bestimmten Speicherort beenden.

Syntax

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

Parameter

[in] pfd

Typ: IFileDialog*

Ein Zeiger auf die Schnittstelle, die den Dialog darstellt.

[in] psiFolder

Typ: IShellItem*

Ein Zeiger auf eine Schnittstelle, die den Ordner darstellt, zu dem das Dialogfeld gerade navigiert.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Der Rückgabewert S_OK oder E_NOTIMPL gibt an, dass die Ordneränderung fortgesetzt werden kann.

Hinweise

Die aufrufende Anwendung kann während dieses Rückrufs IFileDialog::SetFolder aufrufen, um die Navigation an einen alternativen Ordner umzuleiten. Die eigentliche Navigation erfolgt erst, wenn IFileDialogEvents::OnFolderChanging zurückgegeben wurde.

Wenn die aufrufende Anwendung einfach die Navigation zu einem bestimmten Ordner verhindert, sollte die Benutzeroberfläche mit einer Erklärung der Einschränkung angezeigt werden. Um einen übergeordneten HWND für die Benutzeroberfläche zu erhalten, rufen Sie die IOleWindow-Schnittstelle über IFileDialog ab, und rufen Sie IOleWindow::GetWindow auf.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Freigeben über