UniformGridLayout クラス

定義

名前空間:

Microsoft.UI.Xaml.Controls

折り返しレイアウトで、要素を左から右または上から下に順番に配置します。

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [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 UniformGridLayout : VirtualizingLayout

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[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 UniformGridLayout : VirtualizingLayout

Public Class UniformGridLayout
Inherits VirtualizingLayout

継承

DependencyObject

Layout

VirtualizingLayout

UniformGridLayout

属性

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

例

ヒント

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

WinUI 3 ギャラリー アプリと WinUI 2 ギャラリー アプリには、ほとんどの WinUI 3 および WinUI 2 コントロールと機能の対話型の例が含まれています。

既にインストールされている場合は、WinUI 3 ギャラリーまたは WinUI 2 ギャラリーのリンクをクリックして開きます。

インストールされていない場合は、Microsoft Store から WinUI 3 ギャラリーと WinUI 2 ギャラリーをダウンロードできます。

GitHub から両方のソース コードを取得することもできます (WinUI 3 の場合は main ブランチ、WinUI 2 の場合は winui2 ブランチを使用します)。

次の例では、 ItemsRepeater.Layout プロパティを UniformGridLayout に設定する方法を示します。

<!--
    xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->
...
<muxc:ItemsRepeater ItemsSource="{x:Bind Items}"
                    ItemTemplate="{StaticResource MyTemplate}">
    <muxc:ItemsRepeater.Layout>
        <muxc:UniformGridLayout MinItemWidth="200"
                                MinColumnSpacing="28"
                                ItemsJustification="SpaceAround"/>
    </muxc:ItemsRepeater.Layout>
</muxc:ItemsRepeater>

注釈

項目は、向きが 〗の場合は左から右に並べられ、向きが Horizontal〗の場合はVertical上から下にレイアウトされます。

UniformGridLayout 内のすべての項目のサイズは等しくなります。

UniformGridLayout は、仮想化をサポートするホストにアタッチされている場合に仮想化をサポートします。

コンストラクター

UniformGridLayout()

UniformGridLayout クラスの新しいインスタンスを初期化します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。

プロパティ

ItemsJustification	スクロールしない軸または非仮想化軸に項目を配置する方法を示す値を取得または設定します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
ItemsJustificationProperty	ItemsJustification 依存関係プロパティを識別します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
ItemsStretch	使用可能な領域に合わせて項目のサイズを設定する方法を示す値を取得または設定します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
ItemsStretchProperty	ItemsStretch 依存関係プロパティを識別します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MaximumRowsOrColumns	UniformGridLayout の向きに基づいて、行または列ごとにレンダリングされる項目の最大数を取得または設定します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MaximumRowsOrColumnsProperty	MaximumRowsOrColumns 依存関係プロパティを識別します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MinColumnSpacing	横軸の項目間の最小スペースを取得または設定します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MinColumnSpacingProperty	MinColumnSpacing 依存関係プロパティを識別します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MinItemHeight	各項目の最小高さを取得または設定します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MinItemHeightProperty	MinItemHeight 依存関係プロパティを識別します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MinItemWidth	各項目の最小幅を取得または設定します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MinItemWidthProperty	MinItemWidth 依存関係プロパティを識別します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MinRowSpacing	縦軸の項目間の最小スペースを取得または設定します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
MinRowSpacingProperty	MinRowSpacing 依存関係プロパティを識別します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
Orientation	項目をレイアウトする軸を取得または設定します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
OrientationProperty	Orientation 依存関係プロパティを識別します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。

メソッド

Arrange(LayoutContext, Size)	子要素を配置し、コンテナー UIElement のサイズを決定します。 添付レイアウトをサポートするコンテナー要素は、レイアウトオーバーライドの実装からこのメソッドを呼び出して、再帰的なレイアウト更新を形成する必要があります。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)	派生クラスで実装された場合、レイアウトの "配置" パスの動作を提供します。 クラスは、このメソッドをオーバーライドして、独自の "配置" パス動作を定義できます。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 VirtualizingLayout)
InitializeForContext(LayoutContext)	UIElement コンテナーにアタッチされるときにレイアウトに必要なコンテナーごとの状態を初期化します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout)
InitializeForContextCore(VirtualizingLayoutContext)	派生クラスでオーバーライドされると、レイアウトが UIElement コンテナーにアタッチされるときに必要なコンテナーごとの状態を初期化します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 VirtualizingLayout)
InvalidateArrange()	このレイアウトを参照するすべての UIElement コンテナーの配置状態 (レイアウト) を無効にします。 無効化後、UIElement のレイアウトは非同期的に更新されます。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout)
InvalidateMeasure()	このレイアウトを参照するすべての UIElement コンテナーの測定状態 (レイアウト) を無効にします。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout)
Measure(LayoutContext, Size)	コンテナー要素の DesiredSize を提案します。 アタッチされたレイアウトをサポートするコンテナー要素は、独自の MeasureOverride 実装からこのメソッドを呼び出して、再帰的なレイアウト更新を形成する必要があります。 アタッチされたレイアウトは、コンテナーの UIElement の各子に対して Measure を呼び出す必要があります。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout)
MeasureOverride(VirtualizingLayoutContext, Size)	レイアウト サイクルの "Measure" パスの動作を提供します。 クラスはこのメソッドをオーバーライドして、独自の "Measure" パス動作を定義できます。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)	コンテナー要素 (ItemsSource) に割り当てられたデータ コレクションが変更されたときにレイアウトに通知します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 VirtualizingLayout)
UninitializeForContext(LayoutContext)	UIElement コンテナーに以前に格納されていたレイアウトの状態を削除します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout)
UninitializeForContextCore(VirtualizingLayoutContext)	派生クラスでオーバーライドされた場合は、UIElement コンテナーに以前に格納されていたレイアウトの状態をすべて削除します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 VirtualizingLayout)

イベント

ArrangeInvalidated	配置状態 (レイアウト) が無効になっている場合に発生します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout)
MeasureInvalidated	測定状態 (レイアウト) が無効になったときに発生します。 このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout)

こちらもご覧ください

• UniformGridLayoutItemsJustification
• UniformGridLayoutItemsStretch
• UniformGridLayout の概要