ListViewBase.SelectRange(ItemIndexRange) 方法

定義

命名空間:

Windows.UI.Xaml.Controls

選取 ItemIndexRange所描述的專案區塊。

void SelectRange(ItemIndexRange const& itemIndexRange);

public void SelectRange(ItemIndexRange itemIndexRange);

function selectRange(itemIndexRange)

Public Sub SelectRange (itemIndexRange As ItemIndexRange)

參數

itemIndexRange

ItemIndexRange

專案範圍的相關資訊，包括範圍中第一個專案和最後一個專案的索引，以及專案數目。

範例

以下說明如何在名為 itemListView 的ListView中選取前 9 個專案。

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

備註

SelectRange 和 DeselectRange 提供比使用 SelectedItems 屬性更有效率的方式修改選取範圍。 當您使用索引範圍選取項目時，請使用 SelectedRanges 屬性來取得清單中的所有選取範圍。

當您呼叫 SelectRange 時，不論其原始選取狀態為何，都會選取指定範圍中的所有專案。 您可以使用 ItemIndexRange 搭配 FirstIndex 值為 0 且 Length 值等於集合中的專案數，來選取集合中的所有專案。

警告

只有在 SelectionMode 屬性設定為 Multiple 或 Extended時，才呼叫 SelectRange 方法。 如果您在 SelectionMode 為 Single 或 None時呼叫 SelectRange，則會擲回例外狀況。

注意

如果 ItemsSource 實作 IItemsRangeInfo， 則 SelectedItems 集合不會根據清單中的選取專案進行更新。 請改用 SelectedRanges 屬性。

另請參閱

• SelectedRanges
• DeselectRange(ItemIndexRange)
• ItemIndexRange