ContentDialog.DefaultButton Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica quale pulsante nella finestra di dialogo è l'azione predefinita.
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 ContentDialogButtonValore della proprietà
Valore dell'enumerazione. Il valore predefinito è Nessuno.
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 Creators Update (è stato introdotto in 10.0.15063.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v4.0)
|
Commenti
È possibile scegliere facoltativamente di distinguere uno dei tre pulsanti come pulsante predefinito. Specificando il pulsante predefinito, si verificherà quanto segue:
- Il pulsante riceve il trattamento visivo del pulsante Accento
- Il pulsante risponderà automaticamente al tasto INVIO
- Quando l'utente preme il tasto INVIO sulla tastiera, il gestore di clic associato al pulsante predefinito verrà attivato e ContentDialogResult restituirà il valore associato al pulsante predefinito
- Se l'utente ha posizionato lo stato attivo su un controllo che gestisce INVIO, il pulsante predefinito non risponderà alle pressioni INVIO
- Il pulsante riceverà automaticamente lo stato attivo all'apertura della finestra di dialogo, a meno che il contenuto della finestra di dialogo non contenga l'interfaccia utente attivabile
Compatibilità tra versioni
La proprietà DefaultButton non è disponibile prima di Windows 10 versione 1703. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la versione.
Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non impostare questa proprietà in XAML o usarla senza eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.
<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;
}
}