ContentDialog.CloseButtonText Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta il testo da visualizzare sul pulsante di chiusura.

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

Valore della proprietà

String

Platform::String

winrt::hstring

Testo da visualizzare sul pulsante di chiusura.

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

Ogni finestra di dialogo dovrebbe contenere un pulsante di azioni sicuro e non distruttivo che consenta all'utente di chiudere la finestra di dialogo in tutta tranquillità.

Usare il pulsante chiudi per creare questo pulsante. Ciò consente di creare l'esperienza utente appropriata per tutti gli input, inclusi mouse, tastiera, tocco e game pad. La finestra di dialogo verrà chiusa quando:

• L'utente fa clic o tocca il pulsante di chiusura
• L'utente preme il pulsante di sistema Indietro
• L'utente preme il pulsante ESC sulla tastiera
• L'utente preme il pulsante B del game pad

Richiamando il pulsante di chiusura viene restituito ContentDialogResult.None.

Compatibilità tra versioni

La proprietà CloseButtonText 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, è consigliabile usare invece la proprietà SecondaryButtonText . 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", "CloseButtonText"))
    {
        contentDialog1.CloseButtonText = "Cancel";
    }
    else
    {
        contentDialog1.SecondaryButtonText = "Cancel";
    }
}