Layout.IndexBasedLayoutOrientation Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém a orientação, se houver, na qual os itens são dispostos com base em seu índice na coleção de origem.

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

IndexBasedLayoutOrientation IndexBasedLayoutOrientation();

public IndexBasedLayoutOrientation IndexBasedLayoutOrientation { get; }

var indexBasedLayoutOrientation = layout.indexBasedLayoutOrientation;

Public ReadOnly Property IndexBasedLayoutOrientation As IndexBasedLayoutOrientation

Valor da propriedade

IndexBasedLayoutOrientation

Um valor da enumeração que indica a orientação, se houver, na qual os itens são dispostos com base em seu índice na coleção de origem. O padrão é None (consulte Comentários).

Comentários

Cada Layoutclasse derivada de pode especificar seu próprio valor padrão para essa propriedade. NonVirtualizingLayout e VirtualizingLayout especificam IndexBasedLayoutOrientation.None como o padrão. LinedFlowLayout especifica LeftToRight. Layouts personalizados chamam o método SetIndexBasedLayoutOrientation protegido para definir o valor dessa propriedade.

Você pode usar a IndexBasedLayoutOrientation propriedade para determinar se o item no índice N+1 está à direita ou abaixo do item no índice N (ou nenhum deles). Isso permite que um controle como ItemsView implemente corretamente a navegação do teclado com as teclas de direção.

A IndexBasedLayoutOrientation propriedade não tem nenhum efeito sobre o Layout em si. Em vez disso, ele pode ter um efeito sobre os controles que consomem o Layout, como o controle ItemsView . O ItemsView usa o valor dessa propriedade em sua implementação interna de seu método TryGetItemIndex e sua manipulação interna de navegação baseada em teclado.

Por exemplo, o layout LinedFlowLayout especifica LeftToRight. Como resultado, as teclas de seta para a direita e seta para a esquerda se movem para um item com base em seu índice. A tecla de seta para a direita navega para o próximo índice (movendo do índice N para o índice N+1). A tecla de seta para a esquerda navega até o índice anterior (movendo do índice N para o índice N-1). Por outro lado, as teclas de seta para cima e seta para baixo se movem para um item com base em sua posição física.

Quando IndexBasedLayoutOrientation é TopToBottom, os comportamentos são invertidos.

Quando IndexBasedLayoutOrientation é None, todas as quatro teclas de direção se movem para um item com base em sua localização física, em vez de seu índice.

As ilustrações nesta tabela representam visualmente os valores possíveis de IndexBasedLayoutOrientation.

IndexBasedLayoutOrientation	Ilustração
LeftToRight Os itens são dispostos horizontalmente com índices crescentes.
TopToBottom Os itens são dispostos verticalmente com índices crescentes.
None Não há correlação entre o layout dos itens e o número de índice.

Confira também

• SetIndexBasedLayoutOrientation(IndexBasedLayoutOrientation)