Expander クラス

定義

ヘッダーを表示し、コンテンツを表示する折りたたみ可能な本文を持つコントロールを表します。

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.Experimental]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class Expander : ContentControl
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class Expander : ContentControl
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.Experimental]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class Expander : ContentControl
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class Expander : ContentControl
Public Class Expander
Inherits ContentControl
継承
Expander
属性

ヒント

詳細、設計ガイダンス、およびコード例については、「 Expander」を参照してください。

WinUI 2 ギャラリー アプリには、ほとんどの WinUI 2 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。

注釈

ヒント

詳細、設計ガイダンス、およびコード例については、「 Expander の概要」を参照してください。

Expander 使用して、表示領域が制限されている場合に最も重要なコンテンツに焦点を当てます。 Expanderコントロールを使用すると、常に表示されるプライマリ コンテンツの一部に関連する重要度の低いコンテンツを表示または非表示にすることができます。 Header に含まれる項目は常に表示されます。 ユーザーは、ヘッダーを操作することで、セカンダリ コンテンツが表示されるコンテンツ領域を展開および折りたたみることができます。 コンテンツ領域が展開されると、他の UI 要素は非表示になります。他の UI に重ねて表示されません。 Expander は、上または下方向に展開できます。

Header および Content の両方の領域には、単純なテキストから複雑な UI レイアウトまで、任意のコンテンツを含めることができます。

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

既定の StyleControlTemplate を変更して、コントロールに一意の外観を与えることができます。 コントロールのスタイルとテンプレートの変更については、「 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 スタイルに関する記事の「軽量のスタイル設定」セクションを参照してください。

コンストラクター

Expander()

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

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

プロパティ

ExpandDirection

コンテンツ領域の展開方向を示す値を取得または設定します。

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

ExpandDirectionProperty

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

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

Header

Expander のヘッダーに表示される XAML コンテンツを取得または設定します。

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

HeaderProperty

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

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

HeaderTemplate

Expander.Header のデータ テンプレートを取得または設定します。

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

HeaderTemplateProperty

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

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

HeaderTemplateSelector

Header に適用するテンプレートを返すカスタム DataTemplateSelector ロジック クラスへの参照を取得または設定 します

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

HeaderTemplateSelectorProperty

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

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

IsExpanded

Expander のコンテンツ領域を表示するかどうかを示す値を取得または設定します。

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

IsExpandedProperty

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

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

TemplateSettings

Expander のテンプレートを定義するときに TemplatedParent ソースとして参照できる計算値を提供するオブジェクトを取得します。

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

イベント

Collapsed

エキスパンダーのコンテンツ領域が非表示の場合に発生します。

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

Expanding

エキスパンダーのコンテンツ領域が表示され始めると発生します。

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

適用対象

こちらもご覧ください