Freigeben über


UniformGridLayout Klasse

Definition

Positioniert Elemente sequenziell von links nach rechts oder oben nach unten in einem Umbruchlayout.

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

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

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter ItemsRepeater.

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).

Das folgende Beispiel zeigt, wie die ItemsRepeater.Layout-Eigenschaft auf ein UniformGridLayout festgelegt wird.

<!--
    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>

Hinweise

Elemente werden in der Reihenfolge von links nach rechts angeordnet, wenn sich die AusrichtungHorizontalbefindet, und beim Festlegen der AusrichtungVerticalvon oben nach unten angeordnet.

Jedes Element in einem UniformGridLayout ist gleich groß.

UniformGridLayout unterstützt die Virtualisierung, wenn sie an einen Host angefügt wird, der die Virtualisierung unterstützt.

Konstruktoren

UniformGridLayout()

Initialisiert eine neue Instanz der UniformGridLayout-Klasse .

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

Eigenschaften

ItemsJustification

Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie Elemente auf der nicht scrollenden oder nicht virtualisierenden Achse ausgerichtet werden.

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

ItemsJustificationProperty

Identifiziert die ItemsJustification-Abhängigkeitseigenschaft .

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

ItemsStretch

Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie Elemente zum Ausfüllen des verfügbaren Platzes angepasst werden.

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

ItemsStretchProperty

Identifiziert die ItemsStretch-Abhängigkeitseigenschaft .

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

MaximumRowsOrColumns

Ruft die maximale Anzahl von Elementen ab, die pro Zeile oder Spalte gerendert werden, basierend auf der Ausrichtung des UniformGridLayout.

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

MaximumRowsOrColumnsProperty

Identifies the MaximumRowsOrColumns dependency property.

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

MinColumnSpacing

Dient zum Abrufen oder Festlegen des minimalen Abstands zwischen Elementen auf der horizontalen Achse.

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

MinColumnSpacingProperty

Identifiziert die MinColumnSpacing-Abhängigkeitseigenschaft .

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

MinItemHeight

Ruft die Mindesthöhe jedes Elements ab oder legt diese fest.

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

MinItemHeightProperty

Identifiziert die MinItemHeight-Abhängigkeitseigenschaft .

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

MinItemWidth

Ruft die Mindestbreite jedes Elements ab oder legt sie fest.

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

MinItemWidthProperty

Identifiziert die MinItemWidth-Abhängigkeitseigenschaft .

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

MinRowSpacing

Dient zum Abrufen oder Festlegen des minimalen Abstands zwischen Elementen auf der vertikalen Achse.

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

MinRowSpacingProperty

Identifiziert die MinRowSpacing-Abhängigkeitseigenschaft .

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

Orientation

Ruft die Achse ab, auf der Elemente angeordnet sind, oder legt sie fest.

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

OrientationProperty

Identifiziert die Orientation-Abhängigkeitseigenschaft.

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

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 ihrem Layout außer Kraft setzen, 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).

(Geerbt von Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)

Wenn sie in einer abgeleiteten Klasse implementiert werden, wird das Verhalten für den Layoutdurchlauf "Anordnen" bereitgestellt. Klassen können diese Methode außer Kraft setzen, um ihr eigenes "Arrange"-Passverhalten zu definieren.

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

(Geerbt von VirtualizingLayout)
InitializeForContext(LayoutContext)

Initialisiert jeden einzelnen Containerstatus, den das Layout erfordert, 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).

(Geerbt von Layout)
InitializeForContextCore(VirtualizingLayoutContext)

Wenn sie in einer abgeleiteten Klasse überschrieben werden, initialisiert das Layout einen beliebigen Status pro Container, den das Layout erfordert, 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).

(Geerbt von VirtualizingLayout)
InvalidateArrange()

Ungültig wird der Anordnungszustand (Layout) für alle UIElement-Container, die auf dieses Layout verweisen. Nach der Ungültigheit hat das UIElement sein Layout aktualisiert, das asynchron auftritt.

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

(Geerbt von Layout)
InvalidateMeasure()

Ungültig wird der Maßzustand (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).

(Geerbt von Layout)
Measure(LayoutContext, Size)

Schlägt eine DesiredSize für ein Containerelement vor. Ein Containerelement, das angefügte Layouts unterstützt, sollte diese Methode aus ihren eigenen MeasureOverride-Implementierungen aufrufen, um ein rekursives Layoutupdate zu bilden. Das angefügte Layout wird erwartet, dass das Measure für die untergeordneten Elemente des Containers aufgerufen wird.

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

(Geerbt von Layout)
MeasureOverride(VirtualizingLayoutContext, Size)

Stellt das Verhalten für den "Measure"-Pass des Layoutzyklus bereit. Klassen können diese Methode außer Kraft setzen, um ihr eigenes "Measure"-Passverhalten zu definieren.

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

(Geerbt von VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)

Benachrichtigt das Layout, wenn die dem Containerelement zugewiesene Datensammlung (ItemsSource) geändert wurde.

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

(Geerbt von VirtualizingLayout)
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).

(Geerbt von Layout)
UninitializeForContextCore(VirtualizingLayoutContext)

Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt werden, werden alle Status entfernt, die 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).

(Geerbt von VirtualizingLayout)

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).

(Geerbt von Layout)
MeasureInvalidated

Tritt auf, wenn der Maßzustand (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).

(Geerbt von Layout)

Gilt für:

Weitere Informationen