Columns

Typ = [System.Windows.Forms.ListView.ColumnHeaderCollection]

Die Eigenschaft Columns enthält die Spalten des ListView.

Spalten werden hauptsächlich in der Details-Ansicht verwendet.

$listView.View = "Details"

$listView.Columns.Add("Name", 200)
$listView.Columns.Add("Typ", 100)
$listView.Columns.Add("Größe", 100)

Die zweite Angabe bestimmt dabei die Breite der Spalte in Pixeln.

💡 Hinweis Die Spaltenüberschriften werden nur sichtbar, wenn View auf Details gesetzt ist.

CheckBoxes

Typ = [System.Boolean]

Der Wert von CheckBoxes legt fest, ob neben jedem Eintrag eine Checkbox angezeigt wird.

$listView.CheckBoxes = $true

Der Zustand einer Checkbox wird über die Eigenschaft Checked des jeweiligen ListViewItem gesteuert.

$listView.Items[0].Checked = $true

💡 Hinweis Die Checkbox gehört zum jeweiligen ListViewItem und wird nicht über eine separate Collection verwaltet.

FullRowSelect

Typ = [System.Boolean]

Der Wert von FullRowSelect legt fest, ob bei einer Auswahl in der Details-Ansicht die gesamte Zeile markiert wird.

Standardmäßig ist diese Eigenschaft deaktiviert.

$listView.FullRowSelect = $true

Ohne FullRowSelect wird bei der Auswahl hauptsächlich das erste Feld des Eintrags hervorgehoben.

💡 Hinweis Die Eigenschaft ist insbesondere bei tabellarischen Darstellungen sinnvoll, da dadurch deutlich erkennbar ist, welche komplette Zeile ausgewählt wurde.

GridLines

Typ = [System.Boolean]

Der Wert von GridLines legt fest, ob zwischen den Zeilen und Spalten Gitternetzlinien angezeigt werden.

$listView.GridLines = $true

Die Gitternetzlinien werden nur in der Details-Ansicht angezeigt.

Groups

Typ = [System.Windows.Forms.ListViewGroupCollection]

Die Eigenschaft Groups enthält die Gruppen des ListView.

Eine Gruppe kann beispielsweise so erstellt werden:

$group = [System.Windows.Forms.ListViewGroup]::new("Dokumente")

$listView.Groups.Add($group)

Ein ListViewItem kann anschließend einer Gruppe zugewiesen werden:

$item = [System.Windows.Forms.ListViewItem]::new("Dokument.txt")
$item.Group = $group

$listView.Items.Add($item)

Items

Typ = [System.Windows.Forms.ListViewItemCollection]

Die Eigenschaft Items enthält alle Einträge des ListView.

Über die Collection können neue Einträge hinzugefügt, vorhandene Einträge entfernt oder einzelne Einträge abgerufen werden.

$listView.Items.Add("Dokument.txt")

Ein ListViewItem kann auch explizit erstellt werden:

$item = [System.Windows.Forms.ListViewItem]::new("Dokument.txt")

$listView.Items.Add($item)

Die Collection enthält ausschließlich die Haupteinträge. Zusätzliche Spalten werden über die SubItems des jeweiligen ListViewItem verwaltet.

LabelEdit

Typ = [System.Boolean]

Der Wert von LabelEdit legt fest, ob der Benutzer die Beschriftung eines ListViewItem direkt im ListView bearbeiten kann.

$listView.LabelEdit = $true

Wird die Bearbeitung aktiviert, kann der Benutzer beispielsweise durch langsames Doppelklicken auf einen Eintrag dessen Text ändern.

Die Ereignisse BeforeLabelEdit und AfterLabelEdit ermöglichen es, die Bearbeitung zu kontrollieren.

LargeImageList

Typ = [System.Windows.Forms.ImageList]

LargeImageList legt die ImageList für große Symbole fest.

Sie wird insbesondere bei der Darstellungsart LargeIcon verwendet.

$listView.LargeImageList = $imageList
$listView.View = "LargeIcon"

MultiSelect

Typ = [System.Boolean]

Der Wert von MultiSelect legt fest, ob mehrere Einträge gleichzeitig ausgewählt werden können.

Standardmäßig ist MultiSelect auf True gesetzt.

$listView.MultiSelect = $false

Ist MultiSelect deaktiviert, kann immer nur ein ListViewItem ausgewählt werden.

SelectedItems

Typ = [System.Windows.Forms.ListView.SelectedListViewItemCollection]

Die Eigenschaft SelectedItems enthält alle aktuell ausgewählten ListViewItem.

$listView.SelectedItems

Der erste ausgewählte Eintrag kann beispielsweise so abgerufen werden:

$item = $listView.SelectedItems[0]

Write-Host $item.Text

Bei aktiviertem MultiSelect kann die Collection mehrere Einträge enthalten.

⚠️ Hinweis Vor dem Zugriff auf [0] sollte geprüft werden, ob überhaupt ein Eintrag ausgewählt wurde.

if ($listView.SelectedItems.Count -gt 0) {
    $item = $listView.SelectedItems[0]
}

ShowGroups

Typ = [System.Boolean]

Der Wert von ShowGroups legt fest, ob die im Groups-Container definierten Gruppen angezeigt werden.

$listView.ShowGroups = $true

Gruppen werden hauptsächlich verwendet, um größere Mengen von Einträgen logisch zu unterteilen.

SmallImageList

Typ = [System.Windows.Forms.ImageList]

SmallImageList legt die ImageList fest, aus der das ListView kleine Symbole für seine Einträge bezieht.

$listView.SmallImageList = $imageList

Welches Bild für einen bestimmten Eintrag verwendet wird, wird über ImageIndex oder ImageKey des ListViewItem festgelegt.

$item.ImageKey = "document"

Sorting

Typ = [System.Windows.Forms.SortOrder]

Der Wert von Sorting bestimmt, ob und wie die Einträge automatisch sortiert werden.

Folgende Werte stehen zur Verfügung:

$listView.Sorting = "Ascending"

💡 Hinweis Die automatische Sortierung orientiert sich standardmäßig am Text des ListViewItem.

StateImageList

Typ = [System.Windows.Forms.ImageList]

StateImageList enthält Bilder, die den Status eines ListViewItem darstellen.

Sie kann beispielsweise verwendet werden, um unterschiedliche Zustände eines Eintrags visuell darzustellen.

$listView.StateImageList = $stateImageList

Der verwendete Zustand wird über StateImageIndex des jeweiligen ListViewItem festgelegt.

View

Typ = [System.Windows.Forms.View]

Der Wert von View bestimmt, wie die Elemente des ListView dargestellt werden.

Folgende Darstellungsarten stehen zur Verfügung:

Für eine tabellarische Darstellung muss View auf Details gesetzt werden.

$listView.View = "Details"

Beispiel für eine einfache Dateiliste:

$listView.View = "Details"

$listView.Columns.Add("Name", 200)
$listView.Columns.Add("Typ", 100)
$listView.Columns.Add("Größe", 100)

💡 Hinweis Eigenschaften wie Columns, GridLines und FullRowSelect sind insbesondere für die Details-Ansicht relevant.

BeginUpdate()

Die Methode BeginUpdate() verhindert, dass das ListView während umfangreicher Änderungen nach jeder einzelnen Änderung neu gezeichnet wird.

$listView.BeginUpdate()

foreach ($file in $files) {
    $listView.Items.Add($file.Name)
}

$listView.EndUpdate()

Dies ist besonders bei vielen Einträgen sinnvoll.

💡 Hinweis BeginUpdate() sollte immer zusammen mit EndUpdate() verwendet werden. Andernfalls kann die Aktualisierung des Controls ausbleiben. Menschliche Softwareentwicklung hat also auch hier einen „vergessen, wieder einzuschalten“-Modus.

EndUpdate()

Die Methode EndUpdate() beendet die mit BeginUpdate() begonnene Aktualisierungssperre.

$listView.BeginUpdate()

$listView.Items.Clear()
$listView.Items.Add("Eintrag 1")
$listView.Items.Add("Eintrag 2")

$listView.EndUpdate()

Nach EndUpdate() wird das ListView wieder aktualisiert.

Clear()

Die Methode Clear() entfernt alle Einträge und Spalten aus dem ListView.

$listView.Clear()

⚠️ Hinweis Clear() entfernt nicht nur die Items, sondern auch die Columns. Soll ausschließlich der Inhalt entfernt werden, sollte stattdessen Items.Clear() verwendet werden.

$listView.Items.Clear()

EnsureVisible()

Die Methode EnsureVisible() sorgt dafür, dass ein bestimmter Eintrag im sichtbaren Bereich des ListView liegt.

$listView.EnsureVisible(10)

Der angegebene Parameter ist der Index des Eintrags.

Syntax

$listView.EnsureVisible(Index)

FindItemWithText()

Die Methode FindItemWithText() sucht nach einem ListViewItem, dessen Text mit dem angegebenen Suchtext übereinstimmt.

$item = $listView.FindItemWithText("Dokument.txt")

Wird kein passender Eintrag gefunden, wird $null zurückgegeben.

if ($item) {
    Write-Host "Eintrag gefunden: $($item.Text)"
}

GetItemAt()

Die Methode GetItemAt() ermittelt das ListViewItem, das sich an einer bestimmten Position befindet.

$item = $listView.GetItemAt(50, 30)

Die Koordinaten beziehen sich auf das ListView.

Wird an der angegebenen Position kein Eintrag gefunden, wird $null zurückgegeben.

Sort()

Die Methode Sort() führt eine Sortierung der Einträge durch.

$listView.Sort()

Die Sortierreihenfolge wird durch die Eigenschaft Sorting bestimmt.

$listView.Sorting = "Ascending"
$listView.Sort()

ItemSelectionChanged

Das Event ItemSelectionChanged wird ausgelöst, wenn sich der Auswahlzustand eines ListViewItem verändert.

$listView.Add_ItemSelectionChanged({
    param($sender, $e)

    Write-Host "Auswahl geändert: $($e.Item.Text)"
})

Über das Event-Argument $e kann unter anderem auf das betroffene Item zugegriffen werden.

$e.Item

Der neue Auswahlzustand kann über IsSelected ermittelt werden.

if ($e.IsSelected) {
    Write-Host "$($e.Item.Text) wurde ausgewählt."
}

SelectedIndexChanged

Das Event SelectedIndexChanged wird ausgelöst, wenn sich die Auswahl des ListView verändert.

$listView.Add_SelectedIndexChanged({
    param($sender, $e)

    Write-Host "Auswahl geändert."
})

Das Event eignet sich insbesondere, wenn nach einer Änderung der Auswahl mit den aktuell ausgewählten Elementen gearbeitet werden soll.

$listView.Add_SelectedIndexChanged({
    if ($this.SelectedItems.Count -gt 0) {
        Write-Host $this.SelectedItems[0].Text
    }
})

💡 Hinweis Wenn das konkrete betroffene ListViewItem benötigt wird, ist ItemSelectionChanged meist geeigneter.

ItemActivate

Das Event ItemActivate wird ausgelöst, wenn ein ListViewItem aktiviert wird.

Je nach Activation-Einstellung kann dies beispielsweise durch einen einfachen oder doppelten Mausklick erfolgen.

$listView.Add_ItemActivate({
    param($sender, $e)

    if ($this.SelectedItems.Count -gt 0) {
        Write-Host "Aktiviert: $($this.SelectedItems[0].Text)"
    }
})

ItemChecked

Das Event ItemChecked wird ausgelöst, nachdem sich der Checkbox-Zustand eines ListViewItem geändert hat.

$listView.Add_ItemChecked({
    param($sender, $e)

    if ($e.Item.Checked) {
        Write-Host "$($e.Item.Text) aktiviert"
    }
    else {
        Write-Host "$($e.Item.Text) deaktiviert"
    }
})

Im Gegensatz zu ItemCheck findet die Änderung zu diesem Zeitpunkt bereits statt.

ItemCheck

Das Event ItemCheck wird ausgelöst, bevor sich der Checkbox-Zustand eines ListViewItem ändert.

$listView.Add_ItemCheck({
    param($sender, $e)

    Write-Host "Checkbox wird geändert."
})

Das Event eignet sich insbesondere, wenn die Änderung geprüft oder verhindert werden soll.

Der geplante neue Zustand steht in NewValue.

$listView.Add_ItemCheck({
    param($sender, $e)

    Write-Host "Neuer Zustand: $($e.NewValue)"
})

ColumnClick

Das Event ColumnClick wird ausgelöst, wenn der Benutzer auf eine Spaltenüberschrift klickt.

$listView.Add_ColumnClick({
    param($sender, $e)

    Write-Host "Spalte $($e.Column) wurde angeklickt."
})

Column enthält den Index der angeklickten Spalte.

Das Event eignet sich beispielsweise, um beim Klick auf eine Spaltenüberschrift die Sortierreihenfolge zu ändern.

BeforeLabelEdit

Das Event BeforeLabelEdit wird ausgelöst, bevor die Beschriftung eines ListViewItem bearbeitet wird.

$listView.Add_BeforeLabelEdit({
    param($sender, $e)

    Write-Host "Bearbeitung wird gestartet."
})

Die Bearbeitung kann über CancelEdit verhindert werden.

$listView.Add_BeforeLabelEdit({
    param($sender, $e)

    $e.CancelEdit = $true
})

AfterLabelEdit

Das Event AfterLabelEdit wird ausgelöst, nachdem die Beschriftung eines ListViewItem bearbeitet wurde.

$listView.Add_AfterLabelEdit({
    param($sender, $e)

    Write-Host "Neuer Text: $($e.Label)"
})

Über Label kann der neu eingegebene Text abgerufen werden.