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	뷰포트 비율 지점에 가장 가까운 아래쪽 가장자리가 있는 항목을 반환합니다.