ContentDialog.DefaultButton Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece un valor que indica qué botón del cuadro de diálogo es la acción predeterminada.

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 de propiedad

ContentDialogButton

Valor de la enumeración. El valor predeterminado es None.

Requisitos de Windows

Familia de dispositivos	Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)

Comentarios

Opcionalmente, puede elegir diferenciar uno de los tres botones como el botón predeterminado. Especificar el botón predeterminado hace que se produzca lo siguiente:

• El botón recibe el tratamiento visual del botón de énfasis
• El botón responderá a la tecla ENTRAR automáticamente
  • Cuando el usuario presiona la tecla ENTRAR en el teclado, se activará el controlador de clic asociado al botón predeterminado y ContentDialogResult devolverá el valor asociado al botón predeterminado.
  • Si el usuario ha puesto el foco en un control que controla ENTRAR, el botón predeterminado no responderá a las presiones ENTRAR.
• El botón recibirá el foco automáticamente cuando se abra el cuadro de diálogo, a menos que el contenido del diálogo contenga una interfaz de usuario que pueda centrarse.

Compatibilidad de versiones

La propiedad DefaultButton no está disponible antes de Windows 10, versión 1703. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para tener en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no establezca esta propiedad en XAML ni úsela sin realizar una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de establecerla.

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