Metodo IFileDialogEvents::OnFolderChanging (shobjidl_core.h)

Chiamato prima di IFileDialogEvents::OnFolderChange. Ciò consente all'implementatore di arrestare lo spostamento in una determinata posizione.

Sintassi

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

Parametri

[in] pfd

Tipo: IFileDialog*

Puntatore all'interfaccia che rappresenta il dialogo.

[in] psiFolder

Tipo: IShellItem*

Puntatore a un'interfaccia che rappresenta la cartella in cui la finestra di dialogo sta per spostarsi.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo o un valore di errore in caso contrario. Un valore restituito di S_OK o E_NOTIMPL indica che la modifica della cartella può continuare.

Commenti

L'applicazione chiamante può chiamare IFileDialog::SetFolder durante questo callback per reindirizzare lo spostamento a una cartella alternativa. Lo spostamento effettivo non viene eseguito fino a quando non viene restituito IFileDialogEvents::OnFolderChanging .

Se l'applicazione chiamante impedisce semplicemente lo spostamento in una determinata cartella, l'interfaccia utente deve essere visualizzata con una spiegazione della restrizione. Per ottenere un HWND padre per l'interfaccia utente, ottenere l'interfaccia IOleWindow tramite IFileDialog e chiamare IOleWindow::GetWindow.

Requisiti