Freigeben über


InfoBar Klasse

Definition

Ein InfoBar ist eine Inlinebenachrichtigung für wichtige App-übergreifende Nachrichten. Nimmt InfoBar Platz in einem Layout ein und deckt keinen anderen Inhalt ab oder schwebt darüber. Es unterstützt umfangreiche Inhalte (einschließlich Titeln, Nachrichten, Symbolen und Schaltflächen) und kann so konfiguriert werden, dass er vom Benutzer verworfen werden kann oder dauerhaft ist.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Content")]
class InfoBar : Control
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class InfoBar : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Content")]
public class InfoBar : Control
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class InfoBar : Control
Public Class InfoBar
Inherits Control
Vererbung
InfoBar
Attribute

Beispiele

Tipp

Weitere Informationen, Entwurfsleitfäden und Codebeispiele finden Sie unter Infoleiste.

Die App WinUI 2-Katalog umfasst interaktive Beispiele für die meisten WinUI 2-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.

Hinweise

Verwenden Sie ein InfoBar Steuerelement, wenn ein Benutzer über einen geänderten Anwendungszustand informiert werden, bestätigen oder Maßnahmen ergreifen soll. Der geänderte Zustand sollte sich auf die App-Wahrnehmung oder -Erfahrung für den Benutzer auswirken.

Steuerelementstil und -vorlage

Sie können den Standardstil und die ControlTemplate ändern, um dem Steuerelement ein eindeutiges Erscheinungsbild zu verleihen. Informationen zum Ändern des Stils und der Vorlage eines Steuerelements finden Sie unter XAML-Formatvorlagen. Der Standardstil, die Vorlage und die Ressourcen, die das Erscheinungsbild des Steuerelements definieren, sind in der generic.xaml Datei enthalten. Zu Entwurfszwecken generic.xaml wird mit dem NuGet-Paket WinUI (Microsoft.UI.Xaml) installiert. Standardmäßig ist der Speicherort \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Stile und Ressourcen aus verschiedenen WinUI-Versionen können unterschiedliche Werte aufweisen.

XAML enthält auch Ressourcen, mit denen Sie die Farben eines Steuerelements in verschiedenen visuellen Zuständen ändern können, ohne die Steuerelementvorlage zu ändern. Das Ändern dieser Ressourcen wird bevorzugt, um Eigenschaften wie Hintergrund und Vordergrund festzulegen. Weitere Informationen finden Sie im Abschnitt Leichtes Formatieren des Artikels XAML-Formatvorlagen .

Konstruktoren

InfoBar()

Initialisiert eine neue instance der InfoBar-Klasse.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Eigenschaften

ActionButton

Ruft die Aktionsschaltfläche der InfoBar ab oder legt diese fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

ActionButtonProperty

Identifiziert die ActionButton-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

CloseButtonCommand

Ruft den Befehl ab, der aufgerufen werden soll, wenn auf die Schaltfläche zum Schließen in der InfoLeiste geklickt wird, oder legt diesen fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

CloseButtonCommandParameter

Ruft den Parameter ab, der an den Befehl für die Schaltfläche zum Schließen in der InfoLeiste übergeben werden soll, oder legt diesen fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

CloseButtonCommandParameterProperty

Identifiziert die CloseButtonCommandParameter-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

CloseButtonCommandProperty

Identifiziert die CloseButtonCommand-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

CloseButtonStyle

Ruft den ab, der Style auf die Schaltfläche zum Schließen in der InfoLeiste angewendet werden soll, oder legt diesen fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

CloseButtonStyleProperty

Identifiziert die CloseButtonStyle-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Content

Ruft den XAML-Inhalt ab, der unter dem Titel und der Meldung in der InfoBar angezeigt wird, oder legt diesen fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

ContentProperty

Identifiziert die Content-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

ContentTemplate

Ruft die Datenvorlage für infoBar.Content ab oder legt sie fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

ContentTemplateProperty

Identifiziert die ContentTemplate-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

IconSource

Ruft den Grafikinhalt ab, der zusammen mit dem Titel und der Nachricht in der InfoLeiste angezeigt werden soll, oder legt diesen fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

IconSourceProperty

Identifiziert die IconSource-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

IsClosable

Ruft einen Wert ab, der angibt, ob der Benutzer die InfoBar schließen kann, oder legt diesen fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

IsClosableProperty

Identifiziert die IsClosable-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

IsIconVisible

Ruft einen Wert ab, der angibt, ob das Symbol in der InfoLeiste sichtbar ist, oder legt diesen fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

IsIconVisibleProperty

Identifiziert die IsIconVisible-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

IsOpen

Ruft einen Wert ab, der angibt, ob die InfoBar geöffnet ist, oder legt diesen fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

IsOpenProperty

Identifiziert die IsOpen-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Message

Ruft die Meldung der InfoBar ab oder legt sie fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

MessageProperty

Identifiziert die Message-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Severity

Ruft den Typ der InfoLeiste ab, um konsistente status Farb-, Symbol- und Hilfstechnologieeinstellungen abhängig von der Wichtigkeit der Benachrichtigung anzuwenden, oder legt diesen fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

SeverityProperty

Gibt die Abhängigkeitseigenschaft vom Schweregrad an.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

TemplateSettings

Stellt berechnete Werte bereit, auf die beim Definieren von Vorlagen für eine InfoBar als TemplatedParent-Quellen verwiesen werden kann. Nicht für den allgemeinen Gebrauch vorgesehen.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

TemplateSettingsProperty

Identifiziert die TemplateSettings-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Title

Ruft den Titel der InfoBar ab oder legt den Titel fest.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

TitleProperty

Identifiziert die Title-Abhängigkeitseigenschaft .

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Ereignisse

CloseButtonClick

Tritt auf, nachdem auf die Schaltfläche zum Schließen in der Infoleiste geklickt wurde.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Closed

Tritt auf, nachdem die InfoBar geschlossen wurde.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Closing

Tritt kurz vor dem Schließen der InfoBar auf.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Gilt für:

Weitere Informationen