GroupBox

Eine <a href="https://doku.borinas.com/books/klassenwindowsforms/page/groupbox" title="GroupBox">GroupBox</a> ist ein Container zur visuellen Gruppierung von Controls.
Sie dient hauptsächlich dazu, zusammengehörige Eingabefelder, Optionen oder Steuerelemente optisch voneinander abzugrenzen.

Der Text der GroupBox wird als Überschrift im Rahmen dargestellt

Grundlagen

Das GroupBox selbst enthält keine besondere Logik.

• GroupBox → Container mit Beschriftung
• enthaltene Controls → eigentlicher Inhalt

GroupBox erstellen

# Klassisch
$groupBox = New-Object System.Windows.Forms.GroupBox

# .NET-Style
$groupBox = [System.Windows.Forms.GroupBox]::new()

Controls hinzufügen

Controls werden über die Controls-Collection hinzugefügt.

$groupBox.Controls.Add($textBox)

$groupBox.Controls.AddRange(@(
    $label,
    $button
))

Controls entfernen

$groupBox.Controls.Remove($textBox)

$groupBox.Controls.Clear()

Eigenschaften

$groupBox.Controls.Add($button)

$groupBox.Enabled = $false

$groupBox.Padding = 10

$groupBox.Text = "Office Installation"

Methoden

Add()

$_.Controls.Add($control)

Die Methode Add() fügt ein Control zur Controls-Collection der GroupBox hinzu.

AddRange()

$_.Controls.AddRange( @($label, $textbox, $button) )

Die Methode AddRange() fügt mehrere Controls gleichzeitig zur Controls-Collection hinzu.

Remove()

$_.Controls.Remove($control)

Die Methode Remove() entfernt ein bestimmtes Control aus der GroupBox.

Clear()

$_.Controls.Clear()

Die Methode Clear() entfernt alle enthaltenen Controls.

Events

$groupBox.Add_*({
    param($sender, $e)
})

• $sender → Die GroupBox selbst ($this)
• $e → EventArgs des jeweiligen Events

ControlAdded / ControlRemoved

Werden ausgelöst, wenn Controls zur Controls-Collection hinzugefügt oder daraus entfernt werden.

$groupBox.Add_ControlAdded({
    param($sender, $e)

    Write-Host "$($e.Control.Name) wurde hinzugefügt"
})

Tipps & Tricks

Typische Stolperfallen

• Controls erscheinen nicht

  • Position liegt außerhalb der GroupBox

• Alle Controls werden deaktiviert

  • GroupBox.Enabled = $false

• Padding erzeugt kein automatisches Layout

  • Controls müssen weiterhin selbst positioniert werden

• GroupBox für Layout verwendet

  • Für komplexe Layouts meist besser: Panel, FlowLayoutPanel oder TableLayoutPanel

Mentales Modell

Die GroupBox ist ein Container mit Beschriftung.

Sie gruppiert Controls optisch und logisch, besitzt jedoch keine eigene Inhaltslogik.

Wann sinnvoll?

• Einstellungen gruppieren
• Formulare strukturieren
• Optionen zusammenfassen
• RadioButtons logisch gruppieren

Wann vermeiden?

• Komplexe Layouts
• Scrollbare Bereiche
• Dynamische Containerlogik
• Wenn lediglich ein Rahmen benötigt wird