Layout.IndexBasedLayoutOrientation Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft ggf. die Ausrichtung ab, in der Elemente basierend auf ihrem Index in der Quellauflistung angeordnet werden.

public:
 property IndexBasedLayoutOrientation IndexBasedLayoutOrientation { IndexBasedLayoutOrientation get(); };

IndexBasedLayoutOrientation IndexBasedLayoutOrientation();

public IndexBasedLayoutOrientation IndexBasedLayoutOrientation { get; }

var indexBasedLayoutOrientation = layout.indexBasedLayoutOrientation;

Public ReadOnly Property IndexBasedLayoutOrientation As IndexBasedLayoutOrientation

Eigenschaftswert

IndexBasedLayoutOrientation

Ein Wert der -Enumeration, der ggf. die Ausrichtung angibt, in der Elemente basierend auf ihrem Index in der Quellauflistung angeordnet werden. Der Standardwert ist None (siehe Hinweise).

Hinweise

Jede Layoutabgeleitete Klasse kann ihren eigenen Standardwert für diese Eigenschaft angeben. Sowohl NonVirtualizingLayout als auch VirtualizingLayout geben IndexBasedLayoutOrientation.None als Standard an. LinedFlowLayout gibt an LeftToRight. Benutzerdefinierte Layouts rufen die geschützte SetIndexBasedLayoutOrientation-Methode auf, um den Wert dieser Eigenschaft festzulegen.

Sie können die IndexBasedLayoutOrientation -Eigenschaft verwenden, um zu bestimmen, ob sich das Element am Index N+1 rechts oder unterhalb des Elements am Index N befindet (oder keins). Dadurch kann ein Steuerelement wie ItemsView die Tastaturnavigation mit den Pfeiltasten ordnungsgemäß implementieren.

Die IndexBasedLayoutOrientation -Eigenschaft hat keine Auswirkung auf die Layout per se. Stattdessen kann sie sich auf Steuerelemente auswirken, die die Layoutverwenden, z. B. das ItemsView-Steuerelement . Verwendet ItemsView den Wert dieser Eigenschaft in seiner internen Implementierung der TryGetItemIndex-Methode und der integrierten Behandlung der tastaturbasierten Navigation.

Das Layout LinedFlowLayout gibt beispielsweise an LeftToRight. Daher werden die Nach-rechts- und nach-links-Taste basierend auf seinem Index zu einem Element verschoben. Die NACH-RECHTS-TASTE navigiert zum nächsten Index (wechselt von Index N zu Index N+1). Die NACH-LINKS-TASTE navigiert zum vorherigen Index (wechselt von Index zu Index NN-1). Andererseits werden die NACH-OBEN- und NACH-UNTEN-TASTEn basierend auf seiner physischen Position zu einem Element verschoben.

Wenn IndexBasedLayoutOrientation ist TopToBottom, wird das Verhalten umgekehrt.

Wenn IndexBasedLayoutOrientation ist None, werden alle vier Pfeiltasten basierend auf seiner physischen Position und nicht anhand seines Indexes zu einem Element verschoben.

Die Abbildungen in dieser Tabelle stellen die möglichen Werte von IndexBasedLayoutOrientationvisuell dar.

IndexBasedLayoutOrientation	Abbildung
LeftToRight Elemente werden horizontal mit steigenden Indizes angeordnet.
TopToBottom Elemente werden vertikal mit steigenden Indizes angeordnet.
None Es gibt keine Korrelation zwischen dem Layout der Elemente und ihrer Indexnummer.

Weitere Informationen

• SetIndexBasedLayoutOrientation(IndexBasedLayoutOrientation)