ContentDialog.CloseButtonText Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft den Text ab, der auf der Schaltfläche zum Schließen angezeigt werden soll, oder legt diesen fest.

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

Eigenschaftswert

String

Platform::String

winrt::hstring

Der Text, der auf der Schaltfläche zum Schließen angezeigt werden soll.

Windows-Anforderungen

Gerätefamilie	Windows 10 Creators Update (eingeführt in 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v4.0)

Hinweise

Jedes Dialogfeld sollte eine sichere, nicht-destruktive Aktionsschaltfläche enthalten, die dem Benutzer das zuverlässige Beenden ermöglicht.

Verwenden Sie die Schaltfläche schließen, um diese Schaltfläche zu erstellen. Dadurch schaffen Sie die jeweils richtige Benutzerumgebung für alle Eingabemöglichkeiten wie z.B. Maus, Tastatur, Toucheingabe und Gamepad. Das Dialogfeld wird geschlossen, wenn:

• Der Benutzer klickt oder tippt auf die Schaltfläche zum Schließen.
• Der Benutzer die Zurück-Taste des Systems drückt
• Der Benutzer drückt die ESC-Taste auf der Tastatur.
• Der Benutzer auf dem Gamepad die B-Taste drückt

Beim Aufrufen der Schaltfläche zum Schließen wird ContentDialogResult.None zurückgegeben.

Versionskompatibilität

Die CloseButtonText-Eigenschaft ist vor Windows 10 Version 1703 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner ist als die im Anforderungsblock weiter unten auf dieser Seite angezeigte "eingeführte Version", sollten Sie stattdessen die SecondaryButtonText-Eigenschaft verwenden. Weitere Informationen finden Sie unter Versionsadaptiver Code.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um das Vorhandensein dieser Eigenschaft zu überprüfen, bevor Sie sie festlegen.

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