Skip to main content

GroupBox

Eine GroupBox 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

BasicsGrundlagen

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

Eigenschaften / PropertysEigenschaft
    Beschreibung

    Text

    – Überschrift der GroupBox

    Controls – Enthaltene Controls

    Anchor – Verankerung an den Rändern des Parent-Containers

    Dock – Automatische Ausrichtung im Parent-Container

    AutoSize – Größe automatisch an Inhalt anpassen

    Controls Enthaltene Controls Dock Automatische Ausrichtung im Parent-Container Enabled – Aktiviert oder deaktiviert enthaltene Controls

    Visible – Sichtbarkeit der GroupBox

    Font – Schriftart der Überschrift

    ForeColor – Farbe der Überschrift

    Padding – Innenabstand für enthaltene Controls

    Text [System.String]

    Der Wert von Text bestimmt die Beschriftung

    Überschrift der GroupBox.GroupBox

    Standardmäßig

    ist Visible Sichtbarkeit der WertGroupBox leer. 

    $groupBox.Text
    = "Office Installation"
    Controls

    Controls [System.Windows.Forms.Control.ControlCollection]

    Enthält alle Controls, die sich innerhalb der GroupBox befinden.

    $groupBox.Controls.Add($button)

    Enabled

    Enabled [System.Boolean]

    Legt fest, ob die GroupBox aktiviert ist.

    Wird Enabled auf $false gesetzt, werden auch alle enthaltenen Controls deaktiviert.

    $groupBox.Enabled = $false

    Padding

    Padding [System.Windows.Forms.Padding]

    Legt den Innenabstand fest, der zwischen Rahmen und enthaltenen Controls eingehalten wird.

    $groupBox.Padding = 10

    Text

    Text [System.String]

    Der Wert von Text bestimmt die Beschriftung der GroupBox.

    Standardmäßig ist der Wert leer.

    $groupBox.Text = "Office Installation"

    Methoden

    GroupBox.Controls

    Methoden – Controls

    • Add – Fügt ein Control hinzu

    • AddRange – Fügt mehrere Controls hinzu

    • Remove – Entfernt ein Control

    • Clear – Entfernt alle Controls

    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

    Events

    • Click – Mausklick auf die GroupBox

    • DoubleClick – Doppelklick auf die GroupBox

    • MouseDown – Maustaste wurde gedrückt

    • MouseUp – Maustaste wurde losgelassen

    • MouseMove – Maus wurde bewegt

    • MouseEnter – Mauszeiger betritt die GroupBox

    • MouseLeave – Mauszeiger verlässt die GroupBox

    • Enter – Fokus betritt die GroupBox

    • Leave – Fokus verlässt die GroupBox

    • ControlAdded – Ein Control wurde hinzugefügt

    • ControlRemoved – Ein Control wurde entfernt

    • Resize – Größe wurde geändert

    • Paint – GroupBox wird neu gezeichnet

    $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