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 に設定されます。

注釈

このメソッドは、 false コントロールの内部 ItemsRepeater または ScrollView 部分が設定されていないか、データ ソース ItemsSource の が空の場合にを返します。 そのような場合、index out パラメーターは -1 に設定されます。 それ以外の場合、インデックスは 0 以上の値に設定され、 を返します true。

メソッドは TryGetItemIndex 、内部コントロール テンプレート パーツが ItemsView.Loaded 読み込まれるように、イベント ハンドラーまたは後で呼び出すことができます。

入力パラメーターは次のように解釈されます。

引数値	効果
horizontalViewportRatio <= 0.5	ビューポートの比率ポイントに最も近い左端を持つアイテムを返します。
horizontalViewportRatio > 0.5	ビューポートの比率ポイントに最も近い右端を持つアイテムを返します。
verticalViewportRatio <= 0.5	ビューポートの比率ポイントに最も近い上端を持つアイテムを返します。
verticalViewportRatio > 0.5	ビューポートの比率ポイントに最も近い下端を持つアイテムを返します。