Skip to main content

CheckedListBox

Namespace: System.Windows.Forms

Properties / Eigenschaften
  • Property – Standardwert
    Beschreibung oder Erläuterung der Eigenschaft

Verhalten (Behavior)

  • AllowDrop – $false
    Drag & Drop erlauben
  • CheckOnClick – $false
    Checkbox wird direkt beim Klick geändert (ohne zweiten Klick)
  • Enabled – $true
    Aktiv / deaktiviert
  • FormattingEnabled – $true
    Für komplexe Objekte
  • SelectionMode – One
    Auswahlmodus (meist irrelevant hier)
  • Sorted – $false
    Automatisch sortieren
  • ThreeDCheckBoxes – $false
    3D-Darstellung der Checkboxen
  • ScrollAlwaysVisible – $false
    Scrollbar immer anzeigen
  • HorizontalScrollbar – $false
    Horizontale Scrollbar
  • TabStop – $true
    Fokus per Tab

Daten / Inhalt (Data)

  • Items – (leer)
    Alle Einträge
  • CheckedItems – (leer)
    Alle aktiv angehakten Items
  • CheckedIndices – (leer)
    Indizes der angehakten Items
  • SelectedItem – $null
    Aktuell markiertes Item (nicht gleich checked!)
  • TabIndex – 0
    Tab-Reihenfolge

Layout & Position

  • Location – (0,0)
    Position
  • Size – (Width=120, Height=96)
  • Width – (abhängig vom Layout)
  • Height – (abhängig vom Layout)
  • Anchor – (Top, Left)
    Verhalten bei Größenänderung
  • Dock – None
    Layout im Container
  • ItemHeight – (abhängig von Font)

Aussehen (Appearance)

  • BackColor – SystemColors.Window
    Hintergrundfarbe
  • ForeColor – SystemColors.WindowText
    Textfarbe
  • Font – Standard-Systemfont
    Schriftart
  • BorderStyle – Fixed3D
    Rahmenstil (None, FixedSingle, Fixed3D)
  • Visible – $true
    Sichtbarkeit

Meta / System

  • Name – ""
    Interner Name
  • TopIndex – 0
    Oberstes sichtbares Item

Größe

Die CheckedListBox ist im Grunde eine ListBox mit eingebauten Checkboxen. 

CheckedListBox erstellen

$clb = New-Object System.Windows.Forms.CheckedListBox
$clbNew = [System.Windows.Forms.CheckedListBox]::new()

Items hinzufügen

$clb.Items.Add("Apfel")
$clb.Items.Add("Banane")
$clb.Items.AddRange(@("Orange","Mango","Traube"))

📥 Werte auslesen

# Alle angehakten Items
$checked = $clb.CheckedItems

# Indizes
$indices = $clb.CheckedIndices

# Einzelnes Item (nur Fokus, nicht Check!)
$selected = $clb.SelectedItem

👉 Wichtiger Unterschied:
SelectedItem ≠ CheckedItems

  • SelectedItem betrifft nur das Item, welches Ausgewählt ist.
  • CheckedItems beinhaltet alle Items welches auch einen Haken haben

Events - CheckedListBox

Events
  • Event
    Wird ausgelöst, ...
  • TextChanged
    ... wenn sich die Text-Eigenschaft des Controls ändert
Interaktion

  • Click
    ... wenn ein Eintrag der Liste angeklickt wird

  • DoubleClick
    ... wenn ein Eintrag doppelt angeklickt wird

  • ItemCheck
    ... wenn sich der Checked-Zustand eines Items ändert (bevor die Änderung übernommen wird)
  • SelectedIndexChanged
    ... wenn sich die Auswahl (markiertes Item) ändert
Maus

  • MouseEnter
    ... wenn der Mauszeiger die CheckedListBox betritt

  • MouseLeave
    ... wenn der Mauszeiger die CheckedListBox verlässt

  • MouseMove
    ... wenn der Mauszeiger innerhalb der CheckedListBox bewegt wird

  • MouseDown
    ... wenn eine Maustaste auf der CheckedListBox gedrückt wird

  • MouseUp
    ... wenn eine Maustaste auf der CheckedListBox losgelassen wird

  • MouseHover
    ... wenn der Mauszeiger für kurze Zeit auf der CheckedListBox verweilt

Tastatur
  • KeyDown
    ... wenn eine Taste gedrückt wird, während die CheckedListBox den Fokus hat
  • KeyUp 
    ... wenn eine gedrückte Taste wieder losgelassen wird
  • KeyPress 
    ... wenn eine Taste gedrückt wird, die ein Zeichen erzeugt (z. B. Buchstaben, Zahlen)
Fokus
  • Enter
    ... wenn das Control Fokus erhält
  • Leave 
    ... wenn das Control Fokus verliert
Darstellung / Layout

  • Paint
    ... wenn die CheckedLisBox neu gezeichnet wird

  • LocationChanged
    ... wenn sich die Position der CheckedListBox ändert
  • SizeChanged
    ... wenn sich die Größe der CheckedListBox ändert
Zustand

  • EnabledChanged
    ... wenn sich der Enabled-Status der CheckedListBox ändert

  • VisibleChanged
    ... wenn sich die Sichtbarkeit der CheckedListBox ändert

Aussehen

  • FontChanged
    ... wenn sich die Schriftart der CheckedListBox ändert

  • ForeColorChanged
    ... wenn sich die Textfarbe der CheckedListBox ändert

  • BackColorChanged
    ... wenn sich die Hintergrundfarbe der CheckedListBox ändert

Datenbindung
  • DataSourceChanged
    ... wenn sich die Datenquelle ändert
  • DisplayMemberChanged
    ... wenn sich die Anzeigebindung ändert
  • ValueMemberChanged
    ... wenn sich die Wertbindung ändert

ItemCheck

Wird ausgelöst, wenn ein Item gecheckt / ungecheckt wird.
Aber: Zustand ist noch nicht final!

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

Write-Host "Index:" $e.Index
Write-Host "Neu:" $e.NewValue
})

👉 Wenn du hier $clb.CheckedItems liest, bekommst du den alten Zustand.

SelectedIndexChanged

Nur Fokus geändert, nicht der Check.

$clb.Add_SelectedIndexChanged({
Write-Host "Markiert:" $clb.SelectedItem
})

Click

Feuert bei jedem Klick

$clb.Add_Click({
Write-Host "Click erkannt"
})

Tipps & Tricks - CheckedListBox

Check direkt beim Klick

$checkListBox.CheckOnClick = $true

Alle gesetzten Werte holen

$clb.CheckedItems | ForEach-Object {
$_
}

🧩 Check programmatisch setzen

$clb.SetItemChecked(0, $true)

⚠️ Typische Stolperfallen

  • SelectedItem benutzt statt CheckedItems
  • ItemCheck falsch verstanden (Timing!)
  • Doppel-Events durch Click + ItemCheck
  • CheckOnClick = $false → wirkt wie Bug

🧩 Mentales Modell

Die CheckedListBox hat zwei Zustände gleichzeitig:

  1. Fokus (SelectedItem)
  2. Check-Zustand (CheckedItems)

Wenn du das vermischst → Chaos.

🧩 Best Practice

  • Für mehrere unabhängige Optionen → perfekt
  • Für „eine Auswahl“ → falsches Control
  • Für komplexe Daten → lieber eigene UI bauen
Back to top