ItemsView.TryGetItemIndex(Double, Double, Int32) Methode

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft den Index des elements ab, das einer Position relativ zur oberen linken Ecke des ItemsViewam nächsten liegt.

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

Parameter

horizontalViewportRatio

Double

double

Ein -Wert, der bestimmt, ob ein Element zurückgegeben wird, dessen linker oder rechter Rand dem Viewport-Verhältnispunkt am nächsten ist.

verticalViewportRatio

Double

double

Ein -Wert, der bestimmt, ob ein Element zurückgegeben wird, dessen obere oder untere Kante dem Viewport-Verhältnispunkt am nächsten ist.

index

Int32

int

Der Index des nächstgelegenen Elements; oder -1, wenn der Index nicht gefunden wurde.

Gibt zurück

Boolean

bool

true , wenn der Index gefunden wurde. false , wenn das Innere ItemsRepeater oder ScrollView der Teil des Steuerelements nicht festgelegt ist oder die der Datenquelle ItemsSource leer ist, wird der index out-Parameter in diesen Fällen auf -1 festgelegt.

Hinweise

Diese Methode gibt zurück false , wenn das Innere ItemsRepeater oder ScrollView der Teil des Steuerelements nicht festgelegt oder die Datenquelle ItemsSource leer ist. Der Index out-Parameter ist in diesen Fällen auf -1 festgelegt. Andernfalls wird der Index auf einen Wert größer oder gleich 0 festgelegt und gibt zurück true.

Die TryGetItemIndex -Methode kann in einem ItemsView.Loaded Ereignishandler oder zu einem späteren Zeitpunkt aufgerufen werden, sodass die Teile der internen Steuerelementvorlage geladen werden.

Die Eingabeparameter werden wie folgt interpretiert:

Argumentwert	Auswirkung
horizontalViewportRatio <= 0,5	Zurückgeben eines Elements mit dem linken Rand, der dem Viewport-Verhältnispunkt am nächsten ist.
horizontalViewportRatio > 0.5	Gibt ein Element mit dem rechten Rand zurück, der dem Viewport-Verhältnispunkt am nächsten ist.
verticalViewportRatio <= 0,5	Zurückgeben eines Elements mit dem oberen Rand, der dem Viewport-Verhältnispunkt am nächsten ist.
verticalViewportRatio > 0.5	Gibt ein Element mit dem unteren Rand zurück, der dem Viewport-Verhältnispunkt am nächsten ist.