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 时，将取消选择指定范围中的所有项，而不考虑其原始选择状态。 可以使用 FirstIndex 值为 0 且 Length 值等于集合中的项数的 ItemIndexRange 来取消选择集合中的所有项。

注意

如果 ItemsSource 实现 IItemsRangeInfo，则不会根据列表中的选择更新 SelectedItems 集合。 请改用 SelectedRanges 属性。

另请参阅

• SelectedRanges
• SelectRange(ItemIndexRange)
• ItemIndexRange