Freigeben über


ListViewBase.SelectRange(ItemIndexRange) Methode

Definition

Wählt einen Block von Elementen aus, die von ItemIndexRange beschrieben werden.

void SelectRange(ItemIndexRange const& itemIndexRange);
public void SelectRange(ItemIndexRange itemIndexRange);
function selectRange(itemIndexRange)
Public Sub SelectRange (itemIndexRange As ItemIndexRange)

Parameter

itemIndexRange
ItemIndexRange

Informationen zum Bereich der Elemente, einschließlich des Indexes der ersten und letzten Elemente im Bereich, und die Anzahl der Elemente.

Beispiele

Hier erfahren Sie, wie Sie die ersten 9 Elemente in einer ListView mit dem Namen itemListViewauswählen.

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

Hinweise

SelectRange und DeselectRange bieten eine effizientere Möglichkeit zum Ändern der Auswahl als die SelectedItems-Eigenschaft . Verwenden Sie bei der Auswahl von Elementen mit Indexbereichen die SelectedRanges-Eigenschaft, um alle ausgewählten Bereiche in der Liste abzurufen.

Wenn Sie SelectRange aufrufen, werden alle Elemente im angegebenen Bereich ausgewählt, unabhängig vom ursprünglichen Auswahlzustand. Sie können alle Elemente in einer Auflistung auswählen, indem Sie einen ItemIndexRange-Wert mit dem FirstIndex-Wert 0 und einem Length-Wert verwenden, der der Anzahl der Elemente in der Auflistung entspricht.

Warnung

Rufen Sie die SelectRange-Methode nur auf, wenn die SelectionMode-Eigenschaft auf Multiple oder Extended festgelegt ist. Wenn Sie SelectRange aufrufen, wenn selectionModeSingle oder None ist, wird eine Ausnahme ausgelöst.

Hinweis

Wenn itemsSourceIItemsRangeInfo implementiert, wird die SelectedItems-Auflistung nicht basierend auf der Auswahl in der Liste aktualisiert. Verwenden Sie stattdessen die SelectedRanges-Eigenschaft .

Gilt für:

Weitere Informationen