ContentDialog.DefaultButton 屬性

定義

命名空間:

Windows.UI.Xaml.Controls

取得或設定值，這個值表示對話方塊上的哪個按鈕是預設動作。

public:
 property ContentDialogButton DefaultButton { ContentDialogButton get(); void set(ContentDialogButton value); };

ContentDialogButton DefaultButton();

void DefaultButton(ContentDialogButton value);

public ContentDialogButton DefaultButton { get; set; }

var contentDialogButton = contentDialog.defaultButton;
contentDialog.defaultButton = contentDialogButton;

Public Property DefaultButton As ContentDialogButton

屬性值

ContentDialogButton

列舉值。 預設值為 None。

Windows 需求

裝置系列	Windows 10 Creators Update (已於 10.0.15063.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v4.0 引進)

備註

您可以隨意選擇將三個按鈕其中之一區分為預設按鈕。 指定預設按鈕會導致發生下列情況：

• 按鈕將會獲得輔色按鈕視覺效果處理
• 按鈕將會自動回應 ENTER 鍵
  • 當使用者按下鍵盤上的 ENTER 鍵時，會引發與預設按鈕相關聯的 Click 處理常式， 而 ContentDialogResult 會傳回與預設按鈕相關聯的值
  • 如果使用者將焦點放在處理 ENTER 的控制項上，預設按鈕將不會回應 ENTER 按下
• 除非對話方塊的內容包含可焦點 UI，否則按鈕會在開啟對話方塊時自動收到焦點

版本相容性

在 Windows 10 1703 版之前，無法使用 DefaultButton 屬性。 如果您的 App 在 Microsoft Visual Studio 中的「最低平臺版本」設定小於此頁面稍後的 [需求] 區塊中顯示的「引進版本」，您必須設計並測試您的應用程式以考慮此設定。 如需詳細資訊，請參閱 版本調適型程式碼。

若要避免在舊版Windows 10上執行應用程式時發生例外狀況，請勿在 XAML 中設定此屬性，或在不執行執行時間檢查的情況下使用它。 此範例示範如何使用 ApiInformation 類別，在設定此屬性之前檢查此屬性是否存在。

<ContentDialog x:Name="contentDialog1" Loaded="ContentDialog_Loaded">
    ...
</ContentDialog>

private void ContentDialog_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ContentDialog", "DefaultButton"))
    {
        contentDialog1.DefaultButton = ContentDialogButton.Primary;
    }
}