InfoBadge Klasse

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Stellt ein Steuerelement zum Angeben von Benachrichtigungen, Warnungen, neuen Inhalten oder zum Ziehen des Fokus auf einen Bereich innerhalb einer App dar.

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InfoBadge : Control

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class InfoBadge : Control

Public Class InfoBadge
Inherits Control

Vererbung

Control

InfoBadge

Attribute

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Hier sehen Sie ein Beispiel für ein einfaches InfoBadge, das so festgelegt ist, dass die Anzahl der ungelesenen E-Mails angezeigt wird:

<InfoBadge x:Name="emailInfoBadge" Value="{x:Bind numUnreadMail}"/>

Hinweise

Wenn weder InfoBadge.Value noch InfoBadge.IconSource festgelegt sind (Standardwerte werden verwendet), wird infoBadge standardmäßig auf einen Punktindikator festgelegt. Wenn sowohl die Value- als auch die IconSource-Eigenschaft festgelegt sind, wird die Value-Eigenschaft verwendet.

Steuerelementstil und -vorlage

Sie können die Standardvorlagen Style und ControlTemplate ändern, um dem Steuerelement ein eindeutiges Aussehen 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 Aussehen 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-Stile .

Konstruktoren

InfoBadge()

Initialisiert eine neue instance der InfoBadge-Klasse. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Eigenschaften

IconSource	Ruft das Symbol ab, das in einer InfoBadge verwendet werden soll, oder legt es fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IconSourceProperty	Gibt die Abhängigkeitseigenschaft InfoBadge.IconSource an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TemplateSettings	Stellt berechnete Werte bereit, auf die beim Definieren von Vorlagen für eine InfoBadge 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 in der Windows App SDK siehe Windows App SDK Namespaces).
TemplateSettingsProperty	Gibt die Abhängigkeitseigenschaft InfoBadgeTemplateSettings an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
Value	Ruft die ganze Zahl ab, die in einer numerischen InfoBadge angezeigt werden soll, oder legt sie fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
ValueProperty	Gibt die Abhängigkeitseigenschaft InfoBadge.Value an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Weitere Informationen

• InfoBadge Übersicht