語言

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，長度值等於集合中項目數量，來選取集合中的所有項目。

Warning

只有當 SelectionMode 屬性設定為 Multiple 或 Extended 時，才呼叫 SelectRange 方法。 如果你在 SelectionMode 為 Single 或 None 時呼叫 SelectRange，會拋出例外。

Note

若 ItemsSource 實作 IItemsRangeInfo，則 SelectedItems 集合不會根據列表中的選擇更新。 改用 SelectRanges 屬性。

適用於

另請參閱