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 を使用して、コレクション内のすべての項目を選択できます。

Warning

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

Note

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

適用対象

こちらもご覧ください