次の方法で共有


IConsole::MessageBox メソッド (mmc.h)

メッセージ ボックスを表示します。

構文

HRESULT MessageBox(
  [in]  LPCWSTR lpszText,
  [in]  LPCWSTR lpszTitle,
  [in]  UINT    fuStyle,
  [out] int     *piRetval
);

パラメーター

[in] lpszText

表示するメッセージを含む null で終わる文字列へのポインター。

[in] lpszTitle

メッセージ ボックスのタイトルに使用される null で終わる文字列へのポインター。 このパラメーターが NULL の場合は、既定のタイトル "Error" が使用されます。

[in] fuStyle

メッセージ ボックスの内容と動作を決定するビット フラグのセットを指定する 値。 このパラメーターには、Windows API MessageBox のドキュメントから取得した次のフラグ グループのフラグの組み合わせを指定できます。

メッセージ ボックスに表示されるボタンを示すには、次のいずれかのフラグを指定します。

MB_ABORTRETRYIGNORE

メッセージ ボックスには、Abort、Retry、Ignore の 3 つのボタンが含まれています。

MB_OK

メッセージ ボックスには、[OK] というボタンが 1 つ含まれています。 既定値です。

MB_OKCANCEL

メッセージ ボックスには、[OK] と [キャンセル] の 2 つのボタンが含まれています。

MB_RETRYCANCEL

メッセージ ボックスには、再試行とキャンセルの 2 つのボタンが含まれています。

MB_YESNO

メッセージ ボックスには、[はい] と [いいえ] の 2 つのボタンがあります。

MB_YESNOCANCEL

メッセージ ボックスには、[はい]、[いいえ]、[キャンセル] の 3 つのボタンがあります。

メッセージ ボックスに表示されるアイコンを示すには、次のいずれかのフラグを指定します。

MB_ICONEXCLAMATION、MB_ICONWARNING

感嘆符アイコンがメッセージ ボックスに表示されます。

MB_ICONINFORMATION、MB_ICONASTERISK

円の中の "I" で構成されるアイコンがメッセージ ボックスに表示されます。

MB_ICONQUESTION

メッセージ ボックスに疑問符アイコンが表示されます。

MB_ICONSTOP、

MB_ICONERROR、MB_ICONHAND

メッセージ ボックスに停止記号アイコンが表示されます。

既定のボタンを示すには、次のいずれかのフラグを指定します。

MB_DEFBUTTON1

最初のボタンは、このグループ内の他のフラグのいずれかが既定値として指定されていない限り、既定のボタンです。

MB_DEFBUTTON2

2 番目のボタンは既定のボタンです。

MB_DEFBUTTON3

3 番目のボタンは既定のボタンです。

MB_DEFBUTTON4

4 番目のボタンは既定のボタンです。

ダイアログ ボックスのモダリティを示すには、次のいずれかのフラグを指定します。

MB_APPLMODAL

ユーザーは、現在のウィンドウで作業を続行する前に、メッセージ ボックスに応答する必要があります。 ただし、ユーザーは他のアプリケーションのウィンドウに移動し、それらのウィンドウで作業できます。 MB_SYSTEMMODALMB_TASKMODALも指定されていない場合、既定値はMB_APPLMODALです。

MB_SYSTEMMODAL

すべてのアプリケーションは、ユーザーがメッセージ ボックスに応答するまで中断されます。 システム モーダル メッセージ ボックスは、ユーザーに重大で有害な可能性のあるエラーを通知するために使用され、すぐに注意を払う必要があり、慎重に使用する必要があります。

MB_TASKMODAL

MB_APPLMODALに似ていますが、Microsoft Foundation Classes (MFC) アプリケーション内では役に立ちません。 このフラグは、使用可能なウィンドウ ハンドルがない呼び出し元のアプリケーションまたはライブラリ用に予約されています。

さらに、次のフラグを指定できます。

MB_DEFAULT_DESKTOP_ONLY

現在入力を受け取っているデスクトップは、既定のデスクトップである必要があります。それ以外の場合、関数は失敗します。 既定のデスクトップは、ユーザーがログオンした後にアプリケーションが実行されるデスクトップです。

MB_HELP

メッセージ ボックスに [ヘルプ ] ボタンを追加します。 [ヘルプ] ボタンを選択するか、F1 キーを押すと、ヘルプ イベントが生成されます。

MB_RIGHT

テキストは右揃えです。

MB_RTLREADING

ヘブライ語とアラビア語のシステムの右から左への読み取り順序を使用して、メッセージとキャプションテキストを表示します。

MB_SETFOREGROUND

メッセージ ボックスがフォアグラウンド ウィンドウになります。 内部的には、オペレーティング システムはメッセージ ボックスに対して SetForegroundWindow 関数を呼び出します。

MB_TOPMOST

メッセージ ボックスは、 WS_EX_TOPMOST ウィンドウ スタイルで作成されます。

MB_SERVICE_NOTIFICATION

呼び出し元は、ユーザーにイベントを通知するサービスです。 この関数は、コンピューターにログオンしているユーザーがいない場合でも、現在アクティブなデスクトップにメッセージ ボックスを表示します。

このフラグの使用方法の詳細については、 MessageBox 関数を参照してください。

MB_SERVICE_NOTIFICATION_NT3x

この値は、以前のバージョンの Windows の MB_SERVICE_NOTIFICATION に定義されている値に対応します。

[out] piRetval

戻り値へのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

注釈

MessageBox は、スナップインにフォーカスがない場合に発生するエラーを表示するために使用しないでください。 一般的に

MessageBox は、エラーがユーザーの注意を必要とする場合と、エラーにもかかわらず結果ウィンドウに有用な情報が含まれている場合にのみ使用する必要があります。

ほとんどの場合、MMC メッセージ OCX コントロールは、エラー メッセージを表示するより適切な方法です。 詳細については、「 MMC メッセージ OCX コントロールの使用」を参照してください。

要件

要件
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー mmc.h
[DLL] Mmcndmgr.dll

こちらもご覧ください

IConsole