Поделиться через

Класс COleBusyDialog

  • Статья

Используется для диалоговых окон OLE "Сервер не отвечает" или "Сервер занят".

Синтаксис

class COleBusyDialog : public COleDialog

Участники

Открытые конструкторы

Имя Описание
COleBusyDialog::COleBusyDialog Формирует объект COleBusyDialog.

Открытые методы

Имя Описание
COleBusyDialog::D oModal Отображает диалоговое окно "Занято" OLE Server.
COleBusyDialog::GetSelectionType Определяет выбор, сделанный в диалоговом окне.

Открытые члены данных

Имя Описание
COleBusyDialog::m_bz Структура типа OLEUIBUSY, которая управляет поведением диалогового окна.

Замечания

Создайте объект класса COleBusyDialog при вызове этих диалоговых окон. COleBusyDialog После создания объекта можно использовать структуру m_bz для инициализации значений или состояний элементов управления в диалоговом окне. Структура m_bz имеет тип OLEUIBUSY. Дополнительные сведения об использовании этого класса диалоговых окон см. в функции-члене DoModal .

Примечание.

Код контейнера, созданный мастером приложений, использует этот класс.

Дополнительные сведения см . в структуре OLEUIBUSY в пакете SDK для Windows.

Дополнительные сведения о диалоговых окнах, относящихся к OLE, см. в статье "Диалоговые окна" в OLE.

Иерархия наследования

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleBusyDialog

Требования

Заголовок: afxodlgs.h

COleBusyDialog::COleBusyDialog

Эта функция создает COleBusyDialog только объект.

explicit COleBusyDialog(
    HTASK htaskBusy,
    BOOL bNotResponding = FALSE,
    DWORD dwFlags = 0,
    CWnd* pParentWnd = NULL);

Параметры

htaskBusy
Обработка задачи сервера, занятой.

bNotResponding
Если значение TRUE, вызовите диалоговое окно "Не отвечать на запросы" вместо диалогового окна "Занят сервер". Формулировки в диалоговом окне "Не отвечать" немного отличаются от слов в диалоговом окне "Занят сервер", а кнопка "Отмена" отключена.

dwFlags
Флаг создания. Может содержать ноль или больше следующих значений в сочетании с побитовой оператором OR:

  • BZ_DISABLECANCELBUTTON отключить кнопку "Отмена" при вызове диалогового окна.

  • BZ_DISABLESWITCHTOBUTTON Отключить кнопку "Переключиться на" при вызове диалогового окна.

  • BZ_DISABLERETRYBUTTON Отключить кнопку повтора при вызове диалогового окна.

pParentWnd
Указывает на родительский или владелец объекта окна (типа CWnd), к которому принадлежит объект диалогового окна. Если значение NULL, родительское окно объекта диалогового окна устанавливается в главное окно приложения.

Замечания

Чтобы отобразить диалоговое окно, вызовите DoModal.

Дополнительные сведения см . в структуре OLEUIBUSY в пакете SDK для Windows.

COleBusyDialog::D oModal

Вызовите эту функцию, чтобы отобразить диалоговое окно "Занято" или "Сервер не отвечает".

virtual INT_PTR DoModal();

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

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

  • Идентификатор IDOK, если диалоговое окно было успешно отображено.

  • IdCANCEL, если пользователь отменил диалоговое окно.

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

Замечания

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

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

COleBusyDialog::GetSelectionType

Вызовите эту функцию, чтобы получить тип выбора, выбранный пользователем в диалоговом окне "Занят сервер".

UINT GetSelectionType() const;

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

Тип выделенного элемента.

Замечания

Значения возвращаемого COleBusyDialog типа задаются типом Selection перечисления, объявленным в классе.

enum Selection {
    switchTo,
    retry,
    callUnblocked
    };

Краткое описание следующих значений:

  • COleBusyDialog::switchTo Нажата кнопка "Переключиться".

  • COleBusyDialog::retry Нажмите кнопку повтора.

  • COleBusyDialog::callUnblocked Вызов активации сервера теперь разблокирован.

COleBusyDialog::m_bz

Структура типа OLEUIBUSY, используемая для управления поведением диалогового окна "Занят сервер".

OLEUIBUSY m_bz;

Замечания

Элементы этой структуры можно изменять напрямую или через функции-члены.

Дополнительные сведения см . в структуре OLEUIBUSY в пакете SDK для Windows.

См. также

Класс COleDialog
Диаграмма иерархии
Класс COleDialog