InfoBar Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContentPropertyAttribute ContractVersionAttribute
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 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). |