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 成員函式。
注意
應用程式精靈產生的容器程式代碼會使用此類別。
如需詳細資訊,請參閱 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
建立旗標。 可以包含下列與位 OR 運算子結合的零或多個值:
BZ_DISABLECANCELBUTTON呼叫對話框時停用 [取消] 按鈕。
BZ_DISABLESWITCHTOBUTTON呼叫對話框時停用 [切換至] 按鈕。
BZ_DISABLERETRYBUTTON呼叫對話框時停用 [重試] 按鈕。
pParentWnd
指向對話框物件所屬的父視窗對象或擁有者視窗物件(屬於類型 CWnd
)。 如果是 NULL,則對話框物件的父視窗會設定為主要應用程式視窗。
備註
若要顯示對話框,請呼叫 DoModal。
如需詳細資訊,請參閱 Windows SDK 中的 OLEUIBUSY 結構。
COleBusyDialog::D oModal
呼叫此函式以顯示 [OLE Server 忙碌] 或 [伺服器未回應] 對話方塊。
virtual INT_PTR DoModal();
傳回值
對話框的完成狀態。 下列其中一個值:
如果對話框已成功顯示,則為IDOK。
如果使用者取消對話框,IDCANCEL。
如果發生錯誤,則為IDABORT。 如果傳回 IDABORT,請呼叫
COleDialog::GetLastError
成員函式以取得所發生錯誤類型的詳細資訊。 如需可能錯誤的清單,請參閱 Windows SDK 中的 OleUIBusy 函式。
備註
如果您要藉由設定 m_bz 結構的成員來初始化各種對話框控制件,您應該先執行此動作,再呼叫 DoModal
,但在建構對話框物件之後。
如果 DoModal
傳回 IDOK,您可以呼叫其他成員函式,將使用者輸入的設定或資訊擷取到對話框中。
COleBusyDialog::GetSelectionType
呼叫此函式,以取得使用者在 [伺服器忙碌] 對話框中選擇的選取類型。
UINT GetSelectionType() const;
傳回值
所做的選取類型。
備註
傳回型別值是由 Selection
類別中宣告的 COleBusyDialog
列舉型別所指定。
enum Selection {
switchTo,
retry,
callUnblocked
};
這些值的簡短描述如下:
COleBusyDialog::switchTo
已按下 [切換至] 按鈕。COleBusyDialog::retry
已按下 [重試] 按鈕。COleBusyDialog::callUnblocked
立即解除封鎖啟動伺服器的呼叫。
COleBusyDialog::m_bz
OLEUIBUSY 類型的結構,用來控制 [伺服器忙碌] 對話框的行為。
OLEUIBUSY m_bz;
備註
您可以直接或透過成員函式修改此結構的成員。
如需詳細資訊,請參閱 Windows SDK 中的 OLEUIBUSY 結構。