ListViewBase.DeselectRange(ItemIndexRange) 方法

定義

命名空間:

Microsoft.UI.Xaml.Controls

取消選取 ItemIndexRange 所描述的項目區塊。

void DeselectRange(ItemIndexRange const& itemIndexRange);

public void DeselectRange(ItemIndexRange itemIndexRange);

function deselectRange(itemIndexRange)

Public Sub DeselectRange (itemIndexRange As ItemIndexRange)

參數

itemIndexRange

ItemIndexRange

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

範例

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

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

備註

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

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

注意

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

另請參閱

• SelectedRanges
• SelectRange(ItemIndexRange)
• ItemIndexRange