VirtualizingLayout クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ホストの子要素のサイズと配置を行い、仮想化をサポートするオブジェクトの基本クラスを表します。
このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class VirtualizingLayout : Layout/// [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 VirtualizingLayout : Layout[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[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 VirtualizingLayout : Layout[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 VirtualizingLayout : LayoutPublic Class VirtualizingLayout
Inherits Layout- 継承
- 派生
- 属性
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute
例
ヒント
詳細、設計ガイダンス、およびコード例については、「 レイアウト」を参照してください。
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 ブランチを使用します)。
注釈
VirtualizingLayout は、仮想化をサポートするレイアウトの基本クラスです。 指定された派生クラスのいずれかを使用するか、それを継承して独自のレイアウトを作成できます。 提供される具象仮想化レイアウト クラスは 、StackLayout と UniformGridLayout です。
コンストラクター
| VirtualizingLayout() |
VirtualizingLayout クラスの新しいインスタンスを初期化します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 |
メソッド
| Arrange(LayoutContext, Size) |
子要素を配置し、コンテナー UIElement のサイズを決定します。 アタッチされたレイアウトをサポートするコンテナー要素は、レイアウトオーバーライドの実装からこのメソッドを呼び出して、再帰的なレイアウト更新を形成する必要があります。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout) |
| ArrangeOverride(VirtualizingLayoutContext, Size) |
派生クラスで実装された場合、レイアウトの "配置" パスの動作を提供します。 クラスは、このメソッドをオーバーライドして、独自の "配置" パス動作を定義できます。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 |
| InitializeForContext(LayoutContext) |
レイアウトが UIElement コンテナーにアタッチされるときに必要なコンテナーごとの状態を初期化します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout) |
| InitializeForContextCore(VirtualizingLayoutContext) |
派生クラスでオーバーライドされると、レイアウトが UIElement コンテナーにアタッチされるときに必要なコンテナーごとの状態を初期化します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 |
| InvalidateArrange() |
このレイアウトを参照するすべての UIElement コンテナーの配置状態 (レイアウト) を無効にします。 無効化後、UIElement のレイアウトは非同期的に更新されます。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout) |
| InvalidateMeasure() |
このレイアウトを参照するすべての UIElement コンテナーの測定状態 (レイアウト) を無効にします。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout) |
| Measure(LayoutContext, Size) |
コンテナー要素の DesiredSize を提案します。 アタッチされたレイアウトをサポートするコンテナー要素は、独自の MeasureOverride 実装からこのメソッドを呼び出して、再帰的なレイアウト更新を形成する必要があります。 アタッチされたレイアウトは、コンテナーの UIElement の各子に対して Measure を呼び出す必要があります。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout) |
| MeasureOverride(VirtualizingLayoutContext, Size) |
レイアウト サイクルの "メジャー" パスの動作を提供します。 クラスは、このメソッドをオーバーライドして、独自の "Measure" パス動作を定義できます。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 |
| OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs) |
コンテナー要素 (ItemsSource) に割り当てられたデータ コレクションが変更されたときに、レイアウトに通知します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 |
| UninitializeForContext(LayoutContext) |
UIElement コンテナーに以前に格納されていたレイアウトの状態を削除します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout) |
| UninitializeForContextCore(VirtualizingLayoutContext) |
派生クラスでオーバーライドされると、UIElement コンテナーに以前に格納されていたレイアウトの状態をすべて削除します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 |
イベント
| ArrangeInvalidated |
配置状態 (レイアウト) が無効になったときに発生します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout) |
| MeasureInvalidated |
測定状態 (レイアウト) が無効になったときに発生します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 (継承元 Layout) |