COleBusyDialog クラス

  • [アーティクル]

OLE の [サーバーが応答しません] ダイアログ ボックスまたは [サーバーを使用できません] ダイアログ ボックスに使用されます。

構文

class COleBusyDialog : public COleDialog

メンバー

パブリック コンストラクター

名前 説明
COleBusyDialog::COleBusyDialog COleBusyDialog オブジェクトを構築します。

パブリック メソッド

名前 説明
COleBusyDialog::D oModal [OLE Server Busy]\(OLE サーバービジー\) ダイアログ ボックスを表示します。
COleBusyDialog::GetSelectionType ダイアログ ボックスで行う選択を決定します。

パブリック データ メンバー

名前 説明
COleBusyDialog::m_bz ダイアログ ボックスの動作を制御する OLEUIBUSY 型の構造体。

解説

これらのダイアログ ボックスを呼び出す場合は、クラス COleBusyDialog のオブジェクトを作成します。 オブジェクトがCOleBusyDialog構築されたら、m_bz構造体を使用して、ダイアログ ボックス内のコントロールの値または状態を初期化できます。 構造体は m_bz OLEUIBUSY 型です。 このダイアログ クラスの使用方法の詳細については、DoModal メンバー関数を参照してください。

Note

アプリケーション ウィザードによって生成されたコンテナー コードでは、このクラスが使用されます。

詳細については、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
作成フラグ。 ビットごとの OR 演算子と組み合わせた次の値を 0 個以上含めることができます。

  • BZ_DISABLECANCELBUTTON ダイアログ ボックスを呼び出すときに [キャンセル] ボタンを無効にします。

  • BZ_DISABLESWITCHTOBUTTON ダイアログ ボックスを呼び出すときに [切り替え] ボタンを無効にします。

  • BZ_DISABLERETRYBUTTON ダイアログ ボックスを呼び出すときに [再試行] ボタンを無効にします。

pParentWnd
ダイアログ オブジェクトが属する親または所有者ウィンドウ オブジェクト (種類 CWnd) を指します。 NULL の場合、ダイアログ オブジェクトの親ウィンドウは メイン アプリケーション ウィンドウに設定されます。

解説

ダイアログ ボックスを表示するには、DoModal を呼び出します。

詳細については、Windows SDK の OLEUIBUSY 構造体を参照してください。

COleBusyDialog::D oModal

この関数を呼び出して、[OLE サーバーのビジー状態] または [サーバーが応答しない] ダイアログ ボックスを表示します。

virtual INT_PTR DoModal();

戻り値

ダイアログ ボックスの完了状態。 次のいずれかの値:

  • ダイアログ ボックスが正常に表示された場合は IDOK。

  • ユーザーがダイアログ ボックスをキャンセルした場合は IDCANCEL。

  • エラーが発生した場合は IDABORT。 IDABORT が返された場合は、メンバー関数を COleDialog::GetLastError 呼び出して、発生したエラーの種類に関する詳細情報を取得します。 考えられるエラーの一覧については、Windows SDK の OleUIBusy 関数を参照してください。

解説

m_bz構造体のメンバーを設定して、さまざまなダイアログ ボックス コントロールを初期化する場合は、呼び出すDoModal前に、ダイアログ オブジェクトが構築された後に行う必要があります。

IDOK が返された場合 DoModal は、他のメンバー関数を呼び出して、ユーザーがダイアログ ボックスに入力した設定または情報を取得できます。

COleBusyDialog::GetSelectionType

この関数を呼び出して、[サーバービジー] ダイアログ ボックスでユーザーが選択した選択の種類を取得します。

UINT GetSelectionType() const;

戻り値

選択した項目の種類。

解説

戻り値は、クラスで宣言されている列挙型によってSelectionCOleBusyDialog指定されます。

enum Selection {
    switchTo,
    retry,
    callUnblocked
    };

これらの値の簡単な説明は次のとおりです。

  • COleBusyDialog::switchTo [切り替え] ボタンが押されました。

  • COleBusyDialog::retry [再試行] ボタンが押されました。

  • COleBusyDialog::callUnblocked サーバーをアクティブ化するための呼び出しがブロック解除されました。

COleBusyDialog::m_bz

[サーバービジー] ダイアログ ボックスの動作を制御するために使用される OLEUIBUSY 型の構造。

OLEUIBUSY m_bz;

解説

この構造体のメンバーは、直接またはメンバー関数を使用して変更できます。

詳細については、Windows SDK の OLEUIBUSY 構造体を参照してください。

関連項目

COleDialog クラス
階層図
COleDialog クラス