Partilhar via


ContentDialog.CloseButtonText Propriedade

Definição

Obtém ou define o texto a ser exibido no botão Fechar.

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"/>

Valor da propriedade

String

Platform::String

winrt::hstring

O texto a ser exibido no botão Fechar.

Requisitos do Windows

Família de dispositivos
Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v4.0)

Comentários

Cada caixa de diálogo deve conter um botão de ação segura e não destrutiva que permita ao usuário sair da caixa de diálogo com confiança.

Use o botão Fechar para criar esse botão. Isso permite que você crie a experiência do usuário certa para todas as entradas, incluindo mouse, teclado, toque e gamepad. A caixa de diálogo será fechada quando:

  • O usuário clica ou toca no botão Fechar
  • O usuário pressionar o botão Voltar do sistema
  • O usuário pressiona o botão ESC no teclado
  • O usuário pressionar o botão B do Gamepad

Invocar o botão fechar retorna ContentDialogResult.None.

Compatibilidade de versões

A propriedade CloseButtonText não está disponível antes do Windows 10, versão 1703. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor que a "versão introduzida" mostrada no bloco Requisitos posteriormente nesta página, você deverá usar a propriedade SecondaryButtonText . Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não defina essa propriedade em XAML nem use-a sem executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de defini-la.

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

Aplica-se a