ContentDialog.DefaultButton Propriedade

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

Valor da propriedade

Um valor da enumeração. O padrão é None.

Requisitos do Windows

Comentários

Como opção, você pode optar por diferenciar um dos três botões como o botão padrão. A especificação do botão padrão resulta em:

• O botão recebe o tratamento visual de Botão de Destaque
• O botão responderá à tecla ENTER automaticamente
  • Quando o usuário pressionar a tecla ENTER no teclado, o manipulador de cliques associado ao botão padrão será acionado e ContentDialogResult retornará o valor associado ao botão padrão
  • Se o usuário tiver colocado o foco em um controle que manipula ENTER, o botão padrão não responderá aos pressionamentos ENTER
• O botão receberá o foco automaticamente quando a caixa de diálogo for aberta, a menos que o conteúdo da caixa de diálogo contenha interface do usuário focalizável

Compatibilidade de versões

A propriedade DefaultButton 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á projetar e testar seu aplicativo para considerar isso. 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", "DefaultButton"))
    {
        contentDialog1.DefaultButton = ContentDialogButton.Primary;
    }
}

Aplica-se a