Partager via


IFileDialogEvents::OnFolderChanging, méthode (shobjidl_core.h)

Appelé avant IFileDialogEvents::OnFolderChange. Cela permet à l’implémenteur d’arrêter la navigation vers un emplacement particulier.

Syntaxe

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

Paramètres

[in] pfd

Type : IFileDialog*

Pointeur vers l’interface qui représente le dialogue.

[in] psiFolder

Type : IShellItem*

Pointeur vers une interface qui représente le dossier vers lequel la boîte de dialogue est sur le point de naviguer.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. Une valeur de retour S_OK ou E_NOTIMPL indique que le changement de dossier peut se poursuivre.

Remarques

L’application appelante peut appeler IFileDialog::SetFolder pendant ce rappel pour rediriger la navigation vers un autre dossier. La navigation réelle ne se produit pas tant que IFileDialogEvents::OnFolderChanging n’est pas retourné.

Si l’application appelante empêche simplement la navigation vers un dossier particulier, l’interface utilisateur doit s’afficher avec une explication de la restriction. Pour obtenir un HWND parent pour l’interface utilisateur, obtenez l’interface IOleWindow via IFileDialog et appelez IOleWindow::GetWindow.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)