ListViewBase.SelectRange(ItemIndexRange) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
选择 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));
}
注解
与使用 SelectedItems 属性相比,SelectRange 和 DeselectRange 提供了一种更有效的方法来修改所选内容。 当使用索引范围选择项目时,请使用 SelectedRanges 属性获取列表中的所有选定范围。
调用 SelectRange 时,将选中指定范围中的所有项,而不考虑其原始选择状态。 可以使用 FirstIndex 值为 0 且 Length 值等于集合中的项数的 ItemIndexRange 来选择集合中的所有项。
警告
仅当 SelectionMode 属性设置为 Multiple 或 Extended 时,才调用 SelectRange 方法。 如果在 SelectionMode 为 Single 或 None 时调用 SelectRange,则会引发异常。
注意
如果 ItemsSource 实现 IItemsRangeInfo,则不会根据列表中的选择更新 SelectedItems 集合。 请改用 SelectedRanges 属性。