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 を呼び出すと、元の選択状態に関係なく、指定した範囲内のすべての項目が選択されます。 FirstIndex 値が 0 で、Length 値がコレクション内の項目数と等しい ItemIndexRange を使用して、コレクション内のすべての項目を選択できます。

警告

SelectionMode プロパティが Multiple または Extended に設定されている場合にのみ、SelectRange メソッドを呼び出します。 SelectionMode が Single または None のときに SelectRange を呼び出すと、例外がスローされます。

注意

ItemsSource で IItemsRangeInfo が実装されている場合、SelectedItems コレクションはリスト内の選択範囲に基づいて更新されません。 代わりに SelectedRanges プロパティを 使用してください。

こちらもご覧ください

• SelectedRanges
• DeselectRange(ItemIndexRange)
• ItemIndexRange