Layout Klasse

Definition

Stellt die Basisklasse für ein Objekt dar, das untergeordnete Elemente für einen Host größen und anordnet.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

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
Vererbung
Abgeleitet
Attribute
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

Beispiele

Tipp

Weitere Informationen, Entwurfsleitfäden und Codebeispiele finden Sie unter Layout.

Die WinUI 3-Katalog- und WinUI 2-Katalog-Apps umfassen interaktive Beispiele für die meisten WinUI 3- und WinUI 2-Steuerelemente, -Features und -Funktionen.

Wenn sie bereits installiert sind, öffnen Sie sie, indem Sie auf die folgenden Links klicken: WinUI 3-Katalog oder WinUI 2-Katalog.

Wenn sie nicht installiert sind, können Sie den WinUI 3-Katalog und den WinUI 2-Katalog aus dem Microsoft Store herunterladen.

Sie können auch den Quellcode für beide von GitHub abrufen (verwenden Sie denmain-Branch für WinUI 3 und den Branchwinui2 für WinUI 2).

Hinweise

Sie sollten die Layout-Klasse nicht direkt verwenden oder davon erben. Erben Sie stattdessen von den abgeleiteten Klassen NonVirtualizingLayout oder VirtualizingLayout.

Die bereitgestellten konkreten Layoutklassen sind StackLayout und UniformGridLayout.

Methoden

Arrange(LayoutContext, Size)

Positioniert untergeordnete Elemente und bestimmt eine Größe für ein Container-UIElement. Containerelemente, die angefügte Layouts unterstützen, sollten diese Methode aus ihren Layoutüberschreibungsimplementierungen aufrufen, um eine rekursive Layoutaktualisierung zu bilden.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

InitializeForContext(LayoutContext)

Initialisiert jeden einzelnen Containerzustand, den das Layout benötigt, wenn es an einen UIElement-Container angefügt wird.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

InvalidateArrange()

Ungültig wird der Anordnungszustand (Layout) für alle UIElement-Container, die auf dieses Layout verweisen. Nach der Ungültigkeit wird das Layout des UIElement aktualisiert, was asynchron erfolgt.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

InvalidateMeasure()

Ungültig wird der Messzustand (Layout) für alle UIElement-Container, die auf dieses Layout verweisen.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Measure(LayoutContext, Size)

Schlägt einen DesiredSize für ein Containerelement vor. Ein Containerelement, das angefügte Layouts unterstützt, sollte diese Methode aus eigenen MeasureOverride-Implementierungen aufrufen, um ein rekursives Layoutupdate zu bilden. Es wird erwartet, dass das angefügte Layout das Measure für jedes der untergeordneten UIElement-Elemente des Containers aufruft.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

UninitializeForContext(LayoutContext)

Entfernt jeden Zustand, den das Layout zuvor im UIElement-Container gespeichert hat.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Ereignisse

ArrangeInvalidated

Tritt auf, wenn der Anordnungszustand (Layout) ungültig wurde.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

MeasureInvalidated

Tritt auf, wenn der Messzustand (Layout) ungültig wurde.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Gilt für:

Weitere Informationen