ItemsView.TryGetItemIndex(Double, Double, Int32) 方法

定义

命名空间:

Microsoft.UI.Xaml.Controls

检索最接近某个位置的项的索引，该位置相对于 的左上角 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

参数

horizontalViewportRatio

Double

double

一个 值，该值确定是返回其左边缘还是右边缘最接近视区比率点的项。

verticalViewportRatio

Double

double

一个 值，该值确定是返回其上边缘还是下边缘最接近视区比率点的项。

index

Int32

int

最近的项的索引;或 ，如果找不到索引，则为 -1。

返回

Boolean

bool

true 如果找到索引，则为 。 false 如果未设置控件的内部 ItemsRepeater 或 ScrollView 部件，或者数据源的 ItemsSource 为空，则为 ;在这些情况下， index out 参数设置为 -1。

注解

如果未设置控件的内部ItemsRepeater或ScrollView部件，或者数据源的 ItemsSource 为空，则此方法返回 false 。 在这些情况下，index out 参数设置为 -1。 否则，索引设置为大于或等于 0 的值，并返回 true。

TryGetItemIndex可以在事件处理程序中ItemsView.Loaded或以后调用 方法，以便加载内部控件模板部分。

输入参数的解释如下：

参数值	效果
horizontalViewportRatio <= 0.5	返回左边缘最接近视区比率点的项目。
horizontalViewportRatio > 0.5	返回右边缘最接近视区比率点的项目。
verticalViewportRatio <= 0.5	返回上边缘最接近视区比率点的项目。
verticalViewportRatio > 0.5	返回下边缘最接近视区比率点的项目。