COleInsertDialog::DoModal

Статья
02/20/2013

Эта функция вызывается для отображения диалогового окна объекта OLE вставки.

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

Параметры

dwFlags
Одно из следующих значений:

COleInsertDialog::DocObjectsOnly только добавляет DocObjects.

COleInsertDialog::ControlsOnly только добавляет управления ActiveX.

Ноль вставляет ни DocObject, ни элемент управления ActiveX.Это значение приводит к тому, что один и тот же реализация, как первый местозаполнитель перечисленные выше.

Возвращаемое значение

Состояние завершения диалога.Одно из следующих значений:

IDOK если диалоговое окно было успешно.
IDCANCEL если пользователь отменил диалоговое окно.
IDABORT если возникла ошибка.Если возвращается IDABORT, вызовите функцию-член COleDialog::GetLastError чтобы получить дополнительные сведения о типе возникшей ошибки.Для списка возможных ошибок см. в описании функции OleUIInsertObject в Windows SDK.

Заметки

Если необходимо инициализировать разными управления диалогового окна элементами параметра структуры m_io, то это необходимо сделать до вызова DoModal, но после того, как объект диалогового окна.

Если DoModal возвращает IDOK, можно вызывать другие функции-члены для получения параметров или ввод сведений в диалоговое окно пользователем.