ItemsView.TryGetItemIndex(Double, Double, Int32) Método

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Recupera o índice do item mais próximo a uma posição em relação ao canto superior esquerdo do ItemsView.

public:
 virtual bool TryGetItemIndex(double horizontalViewportRatio, double verticalViewportRatio, [Out] int & index) = TryGetItemIndex;

bool TryGetItemIndex(double const& horizontalViewportRatio, double const& verticalViewportRatio, [Out] int & index);

public bool TryGetItemIndex(double horizontalViewportRatio, double verticalViewportRatio, out int index);

Public Function TryGetItemIndex (horizontalViewportRatio As Double, verticalViewportRatio As Double, ByRef index As Integer) As Boolean

Parâmetros

horizontalViewportRatio

Double

double

Um valor que determina se um item com a borda esquerda ou direita mais próxima do ponto de proporção do visor é retornado.

verticalViewportRatio

Double

double

Um valor que determina se um item com sua borda superior ou inferior mais próxima do ponto de proporção do visor é retornado.

index

Int32

int

O índice do item mais próximo; ou - 1 se o índice não foi encontrado.

Retornos

Boolean

bool

true se o índice foi encontrado. false se a parte interna ItemsRepeater ou ScrollView a parte do controle não estiver definida ou se a fonte de ItemsSource dados estiver vazia; o index parâmetro out será definido como -1 nesses casos.

Comentários

Esse método retorna false quando a parte interna ItemsRepeater ou ScrollView parte do controle não está definida ou a da fonte de ItemsSource dados está vazia. O parâmetro index out é definido como -1 nesses casos. Caso contrário, o índice será definido como um valor maior ou igual a 0 e retornará true.

O TryGetItemIndex método pode ser chamado em um ItemsView.Loaded manipulador de eventos ou em qualquer momento posterior para que as partes do modelo de controle interno sejam carregadas.

Os parâmetros de entrada são interpretados da seguinte maneira:

Valor do argumento	Efeito
horizontalViewportRatio <= 0,5	Item de retorno com borda esquerda mais próxima do ponto de proporção do visor.
horizontalViewportRatio > 0.5	Item de retorno com borda direita mais próxima do ponto de proporção do visor.
verticalViewportRatio <= 0,5	Item de retorno com borda superior mais próxima do ponto de proporção do visor.
verticalViewportRatio > 0.5	Item de retorno com borda inferior mais próxima do ponto de proporção do visor.