ListViewBase.SelectRange(ItemIndexRange) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 .