COleInsertDialog::DoModal

Artigo
02/25/2013

Chamar essa função para exibir a caixa de diálogo OLE do objeto de inserção.

virtual INT_PTR 
   DoModal();
INT_PTR 
   DoModal(
   DWORD dwFlags 
);

Parâmetros

dwFlags
Um dos seguintes valores:

COleInsertDialog::DocObjectsOnly insere somente DocObjects.

COleInsertDialog::ControlsOnly insere somente controles ActiveX.

Zero ou inserirem um DocObject ou um controle ActiveX.Esse valor resulta na mesma implementação que o primeiro protótipo listado acima.

Valor de retorno

Status de conclusão da caixa de diálogo.Um dos seguintes valores:

IDOK se a caixa de diálogo for exibida com êxito.
IDCANCEL se o usuário cancelou a caixa de diálogo.
IDABORT se um erro ocorrer.Se IDABORT é retornado, chame a função de membro de COleDialog::GetLastError para obter mais informações sobre o tipo de erro que ocorreu.Para obter uma lista de possíveis erros, consulte a função de OleUIInsertObject em Windows SDK.

Comentários

Se você deseja inicializar vários controles de caixa de diálogo definindo membros de estrutura de m_io , você deve fazê-lo antes de chamar DoModal, mas após o objeto da caixa de diálogo é construído.

Se DoModal retorna IDOK, você pode chamar outras funções de membro para recuperar as configurações ou a entrada de informações na caixa de diálogo pelo usuário.