UniformGridLayout クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
折り返しレイアウトで、要素を左から右または上から下に順番に配置します。
このドキュメントは、WinUI 2 for UWP に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [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.Version(1)]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class UniformGridLayout : VirtualizingLayout[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[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.Version(1)]
public 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 : VirtualizingLayoutPublic Class UniformGridLayout
Inherits VirtualizingLayout- 継承
- 属性
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute 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) |