ListViewBase.SelectRange(ItemIndexRange) 메서드

정의

ItemIndexRange에서 설명하는 항목 블록을 선택합니다.

void SelectRange(ItemIndexRange const& itemIndexRange);
public void SelectRange(ItemIndexRange itemIndexRange);
function selectRange(itemIndexRange)
Public Sub SelectRange (itemIndexRange As ItemIndexRange)

매개 변수

itemIndexRange
ItemIndexRange

범위의 첫 번째 항목과 마지막 항목의 인덱스 및 항목 수를 포함하여 항목 범위에 대한 정보입니다.

예제

라는 ListViewitemListView에서 처음 9개 항목을 선택하는 방법은 다음과 같습니다.

if (itemListView.SelectionMode == ListViewSelectionMode.Multiple ||
    itemListView.SelectionMode == ListViewSelectionMode.Extended)
{
    itemListView.SelectRange(new ItemIndexRange(0, 9));
}

설명

SelectRange 및 DeselectRangeSelectedItems 속성을 사용하는 것보다 선택 영역을 수정하는 보다 효율적인 방법을 제공합니다. 인덱스 범위를 사용하여 항목을 선택할 경우 SelectedRanges 속성을 사용하여 목록의 선택된 모든 범위를 가져옵니다.

SelectRange를 호출하면 원래 선택 상태에 관계없이 지정된 범위의 모든 항목이 선택됩니다. FirstIndex 값이 0이고 Length 값이 컬렉션의 항목 수와 같은 ItemIndexRange를 사용하여 컬렉션의 모든 항목을 선택할 수 있습니다.

경고

SelectionMode 속성이 Multiple 또는 Extended로 설정된 경우에만 SelectRange 메서드를 호출합니다. SelectionModeSingle 또는 None일 때 SelectRange를 호출하면 예외가 throw됩니다.

참고

ItemsSourceIItemsRangeInfo를 구현하는 경우 SelectedItems 컬렉션은 목록의 선택에 따라 업데이트되지 않습니다. 대신 SelectedRanges 속성을 사용합니다.

적용 대상

추가 정보