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";
    }
}