Layout.IndexBasedLayoutOrientation Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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 Layout
classe 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. |