ContentDialog.CloseButtonText 属性

定义

命名空间:

Windows.UI.Xaml.Controls

获取或设置要显示在关闭按钮上的文本。

public:
 property Platform::String ^ CloseButtonText { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring CloseButtonText();

void CloseButtonText(winrt::hstring value);

public string CloseButtonText { get; set; }

var string = contentDialog.closeButtonText;
contentDialog.closeButtonText = string;

Public Property CloseButtonText As String

<ContentDialog CloseButtonText="string"/>

属性值

String

Platform::String

winrt::hstring

要显示在关闭按钮上的文本。

Windows 要求

设备系列	Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

注解

每个对话框都应包含一个可使用户安心退出对话框的安全、无破坏性的操作按钮。

使用“关闭”按钮创建此按钮。 这样便可以为包括鼠标、键盘、触控和游戏板在内的所有输入创建适当的用户体验。 对话框将在以下情况下关闭：

• 用户单击或点击关闭按钮
• 用户按下系统后退按钮
• 用户按下键盘上的 ESC 按钮
• 用户按下游戏板 B

调用关闭按钮将返回 ContentDialogResult.None。

版本兼容性

CloseButtonText 属性在 Windows 10 版本 1703 之前不可用。 如果应用在 Microsoft Visual Studio 中的“最低平台版本”设置小于本页稍后的“要求”块中显示的“引入版本”，则应改用 SecondaryButtonText 属性。 有关详细信息，请参阅 版本自适应代码。

若要避免应用在以前版本的 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", "CloseButtonText"))
    {
        contentDialog1.CloseButtonText = "Cancel";
    }
    else
    {
        contentDialog1.SecondaryButtonText = "Cancel";
    }
}