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 のダイアログ ボックス」を参照してください。
継承階層
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 構造体を参照してください。