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 請顯示標題列中有 [ 確定 ] 按鈕和 [ 關閉] 按鈕的訊息方塊。

您也可以使用訊息方塊來詢問使用者問題。 使用者會按一下您指定為使用 MessageBoxButton 列舉顯示的數個按鈕之一來回答。 您可以將這個列舉傳遞至方法的數個 Show 多載。 列舉的 MessageBoxButton 預設值為 OK 。

您可以檢查傳回的值 Show 來判斷使用者按一下哪一個按鈕。 傳回值是 列舉的值 MessageBoxResult ，其中每個值都等於訊息方塊可以顯示的其中一個按鈕。 訊息方塊的預設值是 OK ，因為 [確定 ] 是預設訊息方塊按鈕。 不過，方法的某些 Show 多載可讓您提供不同的 MessageBoxResult 預設值。

訊息方塊可以傳達資訊，而且可以詢問具有不同重要性程度的問題。 訊息方塊會使用圖示來表示重要性。 例如，圖示可以指出訊息是資訊、是警告，還是很重要。 列舉 MessageBoxImage 會封裝一組可能的訊息方塊圖示。 根據預設，訊息方塊不會顯示圖示。 不過，您可以將值傳遞至數 Show 個方法多載的其中一個 MessageBoxImage ，以指定訊息方塊包含圖示。

訊息方塊有時會提供特殊功能，例如從右至左閱讀。 您可以使用方法的某些多載 Show 所接受的一或多個 MessageBoxOptions 列舉值來自訂訊息方塊的行為。

訊息方塊一律有擁有者視窗。 根據預設，訊息方塊的擁有者是在開啟訊息方塊時，應用程式中目前作用中的視窗。 不過，您可以使用數 Show 個多載的其中一個，為 Window 指定另一個擁有者。 如需擁有者視窗的詳細資訊，請參閱 Window.Owner 。

如需詳細資訊，請參閱 MessageBox 範例。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Show(String)	顯示訊息方塊，該訊息方塊含有訊息並傳回結果。
Show(String, String)	顯示訊息方塊，該訊息方塊含有訊息和標題列標題並傳回結果。
Show(String, String, MessageBoxButton)	顯示訊息方塊，該訊息方塊含有訊息、標題列標題和按鈕並傳回結果。
Show(String, String, MessageBoxButton, MessageBoxImage)	顯示訊息方塊，該訊息方塊含有訊息、標題列標題、按鈕和圖示並傳回結果。
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	顯示訊息方塊，該訊息方塊含有訊息、標題列標題、按鈕和圖示、接受預設訊息方塊結果並傳回結果。
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	顯示訊息方塊，該訊息方塊含有訊息、標題列標題、按鈕和圖示、接受預設訊息方塊結果、遵循指定之選項並傳回結果。
Show(Window, String)	在指定的視窗前顯示訊息方塊。 訊息方塊會顯示訊息並傳回結果。
Show(Window, String, String)	在指定的視窗前顯示訊息方塊。 訊息方塊會顯示訊息和標題列標題，並傳回結果。
Show(Window, String, String, MessageBoxButton)	在指定的視窗前顯示訊息方塊。 訊息方塊會顯示訊息、標題列標題和按鈕，還會傳回結果。
Show(Window, String, String, MessageBoxButton, MessageBoxImage)	在指定的視窗前顯示訊息方塊。 訊息方塊會顯示訊息、標題列標題、按鈕和圖示，還會傳回結果。
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	在指定的視窗前顯示訊息方塊。 訊息方塊會顯示訊息、標題列標題、按鈕和圖示、接受預設訊息方塊結果並傳回結果。
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	在指定的視窗前顯示訊息方塊。 訊息方塊會顯示訊息、標題列標題、按鈕和圖示、且接受預設訊息方塊結果、遵循指定之選項並傳回結果。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• MessageBoxButton
• MessageBoxImage
• MessageBoxResult
• MessageBoxOptions