COleBusyDialog 类

  • 项目

用于 OLE“服务器未响应”或“服务器忙”对话框。

语法

class COleBusyDialog : public COleDialog

成员

公共构造函数

名称 描述
COleBusyDialog::COleBusyDialog 构造 COleBusyDialog 对象。

公共方法

名称 描述
COleBusyDialog::DoModal 显示“OLE 服务器忙碌”对话框。
COleBusyDialog::GetSelectionType 确定对话框中所做的选择。

公共数据成员

“属性” 描述
COleBusyDialog::m_bz 控制对话框行为的 OLEUIBUSY 类型的结构。

备注

要调用此对话框时，请创建类 COleBusyDialog 的对象。 构造 COleBusyDialog 对象后，可以使用 m_bz 结构来初始化对话框中控件的值或状态。 m_bz 结构的类型为 OLEUICHANGEICON。 有关使用此对话框类的详细信息，请参阅 DoModal 成员函数。

注意

应用程序向导生成的容器代码使用此类。

有关详细信息，请参阅 Windows SDK 中的 OLEUIBUSY 结构。

有关特定于 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
创建标志。 可以包含零个或多个与按位或运算符组合的以下值：

  • BZ_DISABLECANCELBUTTON 调用对话框时禁用“取消”按钮。

  • BZ_DISABLESWITCHTOBUTTON 调用对话框时禁用“切换到”按钮。

  • BZ_DISABLERETRYBUTTON 调用对话框时禁用“重试”按钮。

pParentWnd
指向对话框对象所属的父窗口对象或所有者窗口对象（CWnd 类型）。 如果为 NULL，则对话框对象的父窗口设置为主应用程序窗口。

备注

要显示对话框，请调用 DoModal。

有关详细信息，请参阅 Windows SDK 中的 OLEUIBUSY 结构。

COleBusyDialog::DoModal

调用此函数以显示“OLE 服务器忙”或“服务器未响应”对话框。

virtual INT_PTR DoModal();

返回值

对话框的完成状态。 以下值之一：

  • 如果对话框成功显示，为 IDOK。

  • 如果用户取消了对话框，为 IDCANCEL。

  • 如果发生错误，为 IDABORT。 如果返回 IDABORT，请调用 COleDialog::GetLastError 成员函数以获取有关所发生错误类型的详细信息。 有关可能的错误列表，请参阅 Windows SDK 中的 OleUIEditLinks 函数。

备注

如果要通过设置 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;

注解

此结构的成员可以直接进行修改，也可以通过成员函数进行修改。

有关详细信息，请参阅 Windows SDK 中的 OLEUIBUSY 结构。

另请参阅

COleDialog 类
层次结构图
COleDialog 类