ListViewBase.DeselectRange(ItemIndexRange) Methode

Definition

Hebt die Auswahl eines Blocks von Elementen auf, die von ItemIndexRange beschrieben werden.

void DeselectRange(ItemIndexRange const& itemIndexRange);
public void DeselectRange(ItemIndexRange itemIndexRange);
function deselectRange(itemIndexRange)
Public Sub DeselectRange (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 itemListViewaufheben.

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

Hinweise

SelectRange und DeselectRange bieten eine effizientere Möglichkeit zum Ändern der Auswahl als die Verwendung der 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 DeselectRange aufrufen, werden alle Elemente im angegebenen Bereich deaktiviert, unabhängig vom ursprünglichen Auswahlstatus. Sie können die Auswahl aller Elemente in einer Auflistung aufheben, indem Sie einen ItemIndexRange-Wert mit dem FirstIndex-Wert 0 und einem Length-Wert verwenden, der der Anzahl der Elemente in der Auflistung entspricht.

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