InfoBadge クラス

定義

通知、アラート、新しいコンテンツを示したり、アプリ内の領域にフォーカスを引き付けたりするためのコントロールを表します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

/// [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
継承
InfoBadge
属性
Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

未読メールの数を表示するように設定された単純な InfoBadge の例を次に示します。

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

注釈

InfoBadge.ValueInfoBadge.IconSource の両方が設定されていない場合 (既定値が使用されます)、InfoBadge の既定値はドット インジケーターになります。 Value プロパティと IconSource プロパティの両方が設定されている場合は、Value プロパティが使用されます。

コントロールのスタイルとテンプレート

既定の スタイルControlTemplate を変更して、コントロールに一意の外観を与えることができます。 コントロールのスタイルとテンプレートの変更については、「 XAML スタイル」を参照してください。 コントロールの外観を定義する既定のスタイル、テンプレート、およびリソースがファイルに generic.xaml 含まれます。 設計上の目的で、 generic.xaml は WinUI (Microsoft.UI.Xaml) NuGet パッケージと共にインストールされます。 既定では、この場所は \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml です。 WinUI の異なるバージョンのスタイルとリソースの値が異なる場合があります。

XAML には、コントロール テンプレートを変更せずに、さまざまなビジュアル状態のコントロールの色を変更するために使用できるリソースも含まれています。 これらのリソースを変更することは、 Background や Foreground などのプロパティを設定する場合に適 しています。 詳細については、XAML スタイルに関する記事の「軽量スタイル設定」セクションを参照してください。

コンストラクター

InfoBadge()

InfoBadge クラスの新しいインスタンスを初期化します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

プロパティ

IconSource

InfoBadge で使用するアイコンを取得または設定します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

IconSourceProperty

InfoBadge.IconSource 依存関係プロパティを識別します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

TemplateSettings

InfoBadge のテンプレートを定義するときに TemplatedParent ソースとして参照できる計算値を提供します。 一般的な使用を目的としたものではありません。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

TemplateSettingsProperty

InfoBadgeTemplateSettings 依存関係プロパティを識別します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

Value

InfoBadge の数値で表示する整数を取得または設定します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

ValueProperty

InfoBadge.Value 依存関係プロパティを識別します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

適用対象

こちらもご覧ください