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_SYSTEMMODALもMB_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 |