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 键时，将触发与默认按钮关联的单击处理程序， ContentDialogResult 将返回与默认按钮关联的值
  • 如果用户已将焦点放在处理 ENTER 的控件上，则默认按钮不会响应按 Enter 键
• 打开对话框时按钮将自动接收焦点，除非对话框的内容包含可聚焦的 UI

版本兼容性

DefaultButton 属性在 Windows 10 版本 1703 之前不可用。 如果你的应用在 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;
    }
}