Layout クラス

  • リファレンス

定義

名前空間:
Microsoft.UI.Xaml.Controls
編集

ホストの子要素のサイズと配置を行うオブジェクトの基本クラスを表します。

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

public ref class Layout : DependencyObject
/// [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 Layout : DependencyObject
/// [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 Layout : DependencyObject
[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 Layout : DependencyObject
[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 Layout : DependencyObject
Public Class Layout
Inherits DependencyObject
継承
DependencyObject
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 ブランチを使用します)。

注釈

Layout クラスを直接使用したり継承したりしないでください。 代わりに、派生クラス NonVirtualizingLayout または VirtualizingLayout から継承します。

提供される具象レイアウト クラスは 、StackLayout と UniformGridLayout です。

メソッド

Arrange(LayoutContext, Size)

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

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

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

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

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

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

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

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

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

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

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

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

イベント

ArrangeInvalidated

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

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

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

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

適用対象

こちらもご覧ください