IFileDialogEvents::OnFileOk-Methode (shobjidl_core.h)

  • Artikel

Wird kurz aufgerufen, bevor das Dialogfeld mit einem Ergebnis zurückgegeben wird.

Syntax

HRESULT OnFileOk(
  [in] IFileDialog *pfd
);

Parameter

[in] pfd

Typ: IFileDialog*

Ein Zeiger auf die Schnittstelle, die das Dialogfeld darstellt.

Rückgabewert

Typ: HRESULT

Implementierungen sollten S_OK zurückgeben, um das aktuelle Ergebnis im Dialogfeld zu akzeptieren, oder S_FALSE , es abzulehnen. Bei S_FALSE sollte das Dialogfeld geöffnet bleiben.

Hinweise

Wenn diese Methode aufgerufen wird, können die Methoden IFileDialog::GetResult und GetResults aufgerufen werden.

Die Anwendung kann diese Rückrufmethode verwenden, um eine zusätzliche Überprüfung durchzuführen, bevor das Dialogfeld geschlossen wird, oder um zu verhindern, dass das Dialogfeld geschlossen wird. Wenn die Anwendung verhindert, dass das Dialogfeld geschlossen wird, sollte eine Benutzeroberfläche angezeigt werden, um eine Ursache anzugeben. Um einen übergeordneten HWND für die Benutzeroberfläche zu erhalten, rufen Sie die IOleWindow-Schnittstelle über IFileDialog::QueryInterface ab, und rufen Sie IOleWindow::GetWindow auf.

Eine Anwendung kann diese Methode auch verwenden, um ihre gesamte Arbeit rund um das Öffnen oder Speichern von Dateien auszuführen.

Anforderungen

Anforderung Wert
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 (einschließlich Shobjidl.h)