UniformGridLayout クラス

定義

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

/// [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 : VirtualizingLayout
Public Class UniformGridLayout
Inherits VirtualizingLayout
継承
Object IInspectable DependencyObject Layout VirtualizingLayout UniformGridLayout
属性
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

ヒント

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

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

次の例では、 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>

注釈

項目は、Orientation が の場合は左から右に順番にレイアウトされ、Orientation が の場合はVerticalHorizontal上から下にレイアウトされます。

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

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

コンストラクター

UniformGridLayout()

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

プロパティ

Dispatcher

常に Windows アプリ SDK アプリで を返しますnull。 代わりに DispatcherQueue を使用してください。

(継承元 DependencyObject)
DispatcherQueue

このオブジェクトが DispatcherQueue 関連付けられている を取得します。 は DispatcherQueue 、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の にアクセス DependencyObject できる機能を表します。

(継承元 DependencyObject)
IndexBasedLayoutOrientation

ソース コレクション内のインデックスに基づいて項目がレイアウトされる方向 (ある場合) を取得します。

(継承元 Layout)
ItemsJustification

スクロールしない軸または非仮想化軸に項目を配置する方法を示す値を取得または設定します。

ItemsJustificationProperty

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

ItemsStretch

使用可能な領域を埋めるように項目のサイズを設定する方法を示す値を取得または設定します。

ItemsStretchProperty

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

MaximumRowsOrColumns

UniformGridLayout の向きに基づいて、行または列ごとにレンダリングされるアイテムの最大数を取得または設定します。

MaximumRowsOrColumnsProperty

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

MinColumnSpacing

横軸上の項目間の最小スペースを取得または設定します。

MinColumnSpacingProperty

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

MinItemHeight

各項目の最小高さを取得または設定します。

MinItemHeightProperty

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

MinItemWidth

各項目の最小幅を取得または設定します。

MinItemWidthProperty

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

MinRowSpacing

縦軸の項目間の最小スペースを取得または設定します。

MinRowSpacingProperty

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

Orientation

項目をレイアウトする軸を取得または設定します。

OrientationProperty

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

メソッド

Arrange(LayoutContext, Size)

子要素を配置し、コンテナー UIElement のサイズを決定します。 アタッチされたレイアウトをサポートするコンテナー要素は、このメソッドをレイアウトオーバーライド実装から呼び出して、再帰的なレイアウト更新を形成する必要があります。

(継承元 Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)

派生クラスで実装された場合、レイアウトの "配置" パスの動作を提供します。 クラスは、このメソッドをオーバーライドして、独自の "配置" パス動作を定義できます。

(継承元 VirtualizingLayout)
ClearValue(DependencyProperty)

依存関係プロパティのローカル値をクリアします。

(継承元 DependencyObject)
CreateDefaultItemTransitionProvider()

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

(継承元 Layout)
GetAnimationBaseValue(DependencyProperty)

依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。

(継承元 DependencyObject)
GetValue(DependencyProperty)

DependencyObject から依存関係プロパティの現在の有効な値を返します。

(継承元 DependencyObject)
InitializeForContext(LayoutContext)

レイアウトが UIElement コンテナーにアタッチされるときに必要なコンテナーごとの状態を初期化します。

(継承元 Layout)
InitializeForContextCore(VirtualizingLayoutContext)

派生クラスでオーバーライドされると、レイアウトが UIElement コンテナーにアタッチされるときに必要なコンテナーごとの状態を初期化します。

(継承元 VirtualizingLayout)
InvalidateArrange()

このレイアウトを参照するすべての UIElement コンテナーの配置状態 (レイアウト) を無効にします。 無効にすると、UIElement のレイアウトが更新され、非同期的に行われます。

(継承元 Layout)
InvalidateMeasure()

このレイアウトを参照するすべての UIElement コンテナーの測定状態 (レイアウト) を無効にします。

(継承元 Layout)
Measure(LayoutContext, Size)

コンテナー要素の DesiredSize を提案します。 アタッチされたレイアウトをサポートするコンテナー要素は、独自の MeasureOverride 実装からこのメソッドを呼び出して、再帰的なレイアウト更新を形成する必要があります。 アタッチされたレイアウトは、コンテナーの UIElement の各子に対して Measure を呼び出す必要があります。

(継承元 Layout)
MeasureOverride(VirtualizingLayoutContext, Size)

レイアウト サイクルの "メジャー" パスの動作を提供します。 クラスは、このメソッドをオーバーライドして、独自の "Measure" パス動作を定義できます。

(継承元 VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)

コンテナー要素 (ItemsSource) に割り当てられたデータ コレクションが変更されたときに、レイアウトに通知します。

(継承元 VirtualizingLayout)
ReadLocalValue(DependencyProperty)

ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。

(継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。

(継承元 DependencyObject)
SetIndexBasedLayoutOrientation(IndexBasedLayoutOrientation)

IndexBasedLayoutOrientation プロパティの値を設定します。

(継承元 Layout)
SetValue(DependencyProperty, Object)

DependencyObject の依存関係プロパティのローカル値を設定します。

(継承元 DependencyObject)
UninitializeForContext(LayoutContext)

UIElement コンテナーに以前に格納されていたレイアウトの状態を削除します。

(継承元 Layout)
UninitializeForContextCore(VirtualizingLayoutContext)

派生クラスでオーバーライドされると、UIElement コンテナーに以前に格納されていたレイアウトの状態が削除されます。

(継承元 VirtualizingLayout)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。

(継承元 DependencyObject)

イベント

ArrangeInvalidated

配置の状態 (レイアウト) が無効になったときに発生します。

(継承元 Layout)
MeasureInvalidated

測定状態 (レイアウト) が無効になったときに発生します。

(継承元 Layout)

適用対象

こちらもご覧ください