MessageBox クラス

定義

名前空間:
System.Windows
アセンブリ:
PresentationFramework.dll

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

public ref class MessageBox sealed
public sealed class MessageBox
type MessageBox = class
Public NotInheritable Class MessageBox
継承
Object
MessageBox

注釈

メッセージ ボックスは、ユーザーにテキスト メッセージを表示する、事前に作成されたモーダル ダイアログ ボックスです。 メッセージ ボックスを表示するには、MessageBox クラスの静的Show メソッドを呼び出します。 表示されるテキスト メッセージは、 Showに渡す文字列引数です。 Show メソッドのいくつかのオーバーロードでは、タイトル バーのキャプションを指定することもできます。

ユーザーがメッセージ ボックスを閉じ Show 、タイトル バーに [OK] ボタンと [閉じる ] ボタンがあるメッセージ ボックスが表示されます。

メッセージ ボックスを使用して、ユーザーに質問することもできます。 ユーザーは、 MessageBoxButton 列挙体を使用して表示するように指定した複数のボタンのいずれかをクリックして応答します。 この列挙は、 Show メソッドのいくつかのオーバーロードに渡すことができます。 MessageBoxButton列挙体の既定値はOK。

ユーザーがクリックするボタンは、 Show 返される値を調べることで判断できます。 戻り値は MessageBoxResult 列挙体の値です。各値は、メッセージ ボックスに表示できるボタンのいずれかに相当します。 [OK] が既定のメッセージ ボックス ボタンであるため、メッセージ ボックスの既定値はOK。 ただし、 Show メソッドのいくつかのオーバーロードを使用すると、別の MessageBoxResult 既定値を指定できます。

メッセージ ボックスは情報を伝え、重要度が異なる質問をすることができます。 メッセージ ボックスでは、アイコンを使用して重要度を示します。 たとえば、アイコンは、メッセージが情報提供、警告、または重要かどうかを示すことができます。 MessageBoxImage列挙は、使用可能なメッセージ ボックス アイコンのセットをカプセル化します。 既定では、メッセージ ボックスにはアイコンは表示されません。 ただし、メッセージ ボックスにアイコンが含まれていることを指定するために、複数のShow メソッド オーバーロードのいずれかにMessageBoxImage値を渡すことができます。

メッセージ ボックスには、右から左への読み取りなどの特別な機能が用意されている場合があります。 Show メソッドのいくつかのオーバーロードで受け入れられる 1 つ以上のMessageBoxOptions列挙値を使用して、メッセージ ボックスの動作をカスタマイズできます。

メッセージ ボックスには常に所有者ウィンドウがあります。 既定では、メッセージ ボックスの所有者は、メッセージ ボックスが開かれた時点でアプリケーションで現在アクティブになっているウィンドウです。 ただし、複数のShowオーバーロードのいずれかを使用して、Windowの別の所有者を指定できます。 所有者ウィンドウの詳細については、「 Window.Owner」を参照してください。

詳細については、「 メッセージ ボックスのサンプル」を参照してください。

メソッド

名前 説明
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)

メッセージ、タイトル バーのキャプション、ボタン、アイコンを含むメッセージ ボックスを表示します。既定のメッセージ ボックスの結果を受け取り、指定したオプションに準拠し、結果を返します。
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)

メッセージ、タイトル バーのキャプション、ボタン、アイコンを含むメッセージ ボックスを表示します。既定のメッセージ ボックスの結果を受け取り、結果を返します。
Show(String, String, MessageBoxButton, MessageBoxImage)

メッセージ、タイトル バーのキャプション、ボタン、アイコンを含むメッセージ ボックスを表示します。結果を返します。
Show(String, String, MessageBoxButton)

メッセージ、タイトル バーのキャプション、ボタンを含むメッセージ ボックスを表示します。結果を返します。
Show(String, String)

メッセージとタイトル バーのキャプションを含むメッセージ ボックスを表示します。結果を返します。
Show(String)

メッセージを含み、結果を返すメッセージ ボックスを表示します。
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)

指定したウィンドウの前にメッセージ ボックスを表示します。 メッセージ ボックスには、メッセージ、タイトル バーのキャプション、ボタン、アイコンが表示されます。既定のメッセージ ボックスの結果を受け入れ、指定したオプションに準拠して結果を返します。
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)

指定したウィンドウの前にメッセージ ボックスを表示します。 メッセージ ボックスには、メッセージ、タイトル バーのキャプション、ボタン、アイコンが表示されます。既定のメッセージ ボックスの結果を受け入れ、結果を返します。
Show(Window, String, String, MessageBoxButton, MessageBoxImage)

指定したウィンドウの前にメッセージ ボックスを表示します。 メッセージ ボックスには、メッセージ、タイトル バーのキャプション、ボタン、アイコンが表示されます。また、結果も返されます。
Show(Window, String, String, MessageBoxButton)

指定したウィンドウの前にメッセージ ボックスを表示します。 メッセージ ボックスには、メッセージ、タイトル バーのキャプション、およびボタンが表示されます。また、結果も返されます。
Show(Window, String, String)

指定したウィンドウの前にメッセージ ボックスを表示します。 メッセージ ボックスには、メッセージとタイトル バーのキャプションが表示されます。結果を返します。
Show(Window, String)

指定したウィンドウの前にメッセージ ボックスを表示します。 メッセージ ボックスにメッセージが表示され、結果が返されます。
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

適用対象

こちらもご覧ください