ContentDialog.DefaultButton Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que indica qual botão na caixa de diálogo é a ação padrão.

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

ContentDialogButton

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

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

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