ListViewBase.SelectRange(ItemIndexRange) Methode

Definition

Namespace:
Microsoft.UI.Xaml.Controls
Bearbeiten

Wählt einen durch die ItemIndexRangebeschriebenen Elementblock aus.

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

Parameter

itemIndexRange
ItemIndexRange

Informationen zum Elementbereich, einschließlich des Indexes der ersten und letzten Elemente im Bereich und der 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, die Auswahl zu ändern, als die SelectedItems-Eigenschaft zu verwenden. Wenn Sie Elemente mithilfe von Indexbereichen auswählen, verwenden Sie die SelectedRanges-Eigenschaft , um alle ausgewählten Bereiche in der Liste abzurufen.

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

Warning

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

Hinweis

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

Gilt für:

Weitere Informationen