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 中的对话框。
继承层次结构
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 结构。