Método IFileDialogEvents::OnFileOk (shobjidl_core.h)

Chamado pouco antes da caixa de diálogo está prestes a retornar com um resultado.

Sintaxe

HRESULT OnFileOk(
  [in] IFileDialog *pfd
);

Parâmetros

[in] pfd

Tipo: IFileDialog*

Um ponteiro para a interface que representa a caixa de diálogo.

Retornar valor

Tipo: HRESULT

As implementações devem retornar S_OK para aceitar o resultado atual na caixa de diálogo ou S_FALSE para recusá-lo. No caso de S_FALSE, a caixa de diálogo deve permanecer aberta.

Comentários

Quando esse método é chamado, os métodos IFileDialog::GetResult e GetResults podem ser chamados .

O aplicativo pode usar esse método de retorno de chamada para executar validação adicional antes do fechamento da caixa de diálogo ou para impedir que a caixa de diálogo seja fechada. Se o aplicativo impedir que a caixa de diálogo seja fechada, ele deverá exibir uma interface do usuário para indicar uma causa. Para obter um HWND pai para a interface do usuário, obtenha a interface IOleWindow por meio de IFileDialog::QueryInterface e chame IOleWindow::GetWindow.

Um aplicativo também pode usar esse método para executar todo o seu trabalho em torno da abertura ou salvamento de arquivos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)