ItemsView.TryGetItemIndex(Double, Double, Int32) Método
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.
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 BooleanParâ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
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. |