ListViewBase.SelectRange(ItemIndexRange) 方法

定義

命名空間:

Microsoft.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