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

要件

Header: 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を呼び出す前に、ダイアログ オブジェクトを構築した後に行う必要があります。

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 クラス