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。

版本相容性

在 Windows 10 1703 版之前，無法使用 CloseButtonText 屬性。 如果您的應用程式在 Microsoft Visual Studio 中的「最低平臺版本」設定小於此頁面稍後的 Requirements 區塊中顯示的「引進版本」，您應該改用 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";
    }
}