Skip to main content

TabControl

Namespace: System.Windows.Forms

Ein TabControl ist ein Container, der mehrere TabPage-Instanzen verwaltet und zwischen ihnen umschaltet.

Es stellt die Tabs (Reiter) dar und bestimmt, welche TabPage aktuell sichtbar ist.

Grundidee

Das TabControl ist die Steuerung, nicht der Inhalt.

    TabControl → verwaltet Tabs TabPage → enthält den eigentlichen Inhalt

    TabControl erstellen

    # Klassisch
$tabControl = New-Object System.Windows.Forms.TabControl

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

    Tab hinzufügen / entfernen

    # Hinzufügen
$tabControl.TabPages.Add($tabPage1)
$tabControl.TabPages.Add("Mein Tab") # erstellt TabPage (nur Text)
$tabControl.TabPages.Add("Name", "Text") # Name + Text
$tabControl.TabPages.AddRange(@($tabPage2, $tabPage3))
$tabControl.TabPages.Insert(0, $tabPage4)

# Entfernen
$tabControl.TabPages.Remove($tabPage1)
$tabControl.TabPages.RemoveAt(0)
$tabControl.TabPages.Clear()

# technisch möglich, aber nicht empfohlen
$tabControl.Controls.Add($tabPage4)
$tabControl.Controls.AddRange(@($tabPage5, $tabPage6))
$tabControl.Controls.Remove($tabPage2)
$tabControl.Controls.RemoveRange(@($tabPage3, $tabPage4))

    Tab-Auswahl

    # Zugriff auf einzelnes TabPage
$tabControl.TabPages[0]

# Aktiven Tab setzen
$tabControl.SelectedIndex = 0
$tabControl.SelectedTab = $tabPage1

    Properties - TabControl

    Properties Hidden
    • TabPages – (leer)
      Sammlung aller enthaltenen TabPage-Instanzen
    • SelectedIndex – 0
      Index des aktuell aktiven Tabs (0-basiert)
    • SelectedTab – $null
      Referenz auf die aktuell aktive TabPage
    • Alignment – Top
      Position der Tabs (Top, Bottom, Left, Right)
    • Appearance – Normal
      Darstellung der Tabs (Normal, Buttons, FlatButtons)
    • SizeMode – Normal
      Größe der Tabs (Normal, Fixed)
    • ItemSize – (Width=0, Height=0)
      Größe einzelner Tabs (nur relevant bei Fixed)
    • Multiline – False
      Mehrere Reihen von Tabs erlauben
    • HotTrack – False
      Hover-Effekt über Tabs
    • Dock – None
      Layout innerhalb des Parent-Containers (meist Fill)
    • Anchor – (Top, Left)
      Alternative Layoutsteuerung
    • Padding – (6, 3)
      Abstand innerhalb der Tab-Headers
    • RowCount – 0
      Anzahl der Tab-Reihen (relevant bei Multiline)
    • DrawMode – Normal
      Zeichenmodus (Normal, OwnerDrawFixed)
    • ShowToolTips – False
      Tooltips für Tabs aktivieren
    • ImageList – $null
      Ermöglicht Icons in Tabs
    • SelectedImageIndex – -1
      Index des Icons für den aktiven Tab

      Ein 

      TabPagesTabControl –ist ein Container, der mehrere TabPage-Instanzen verwaltet und zwischen ihnen umschaltet.

      Es stellt die Tabs (leer)
      SammlungReiter) allerdar enthaltenenund bestimmt, welche TabPage-Instanzen

       SelectedIndex – 0
      Index des aktuell aktivensichtbar Tabsist. (0-basiert)

      Grundidee

      Das TabControl ist SelectedTab – $null
      Referenz auf die aktuellSteuerung, aktive TabPage

      Alignment – Top
      Positionnicht der TabsInhalt. (Top, Bottom, Left, Right)
      • AppearanceTabControl –→ Normal
        Darstellung der Tabs (Normal, Buttons, FlatButtons)
      SizeMode – Normal
      Größe der Tabs (Normal, Fixed) ItemSize – (Width=0, Height=0)
      Größe einzelner Tabs (nur relevant bei Fixed) Multiline – False
      Mehrere Reihen von Tabs erlauben HotTrack – False
      Hover-Effekt überverwaltet Tabs DockTabPage –→ None
      Layout innerhalb des Parent-Containers (meist Fill)       Anchor – (Top, Left)
      Alternative Layoutsteuerung Padding – (6, 3)
      Abstand innerhalb der Tab-Headers RowCount – 0
      Anzahl der Tab-Reihen (relevant bei Multiline) DrawMode – Normal
      Zeichenmodus (Normal, OwnerDrawFixed) ShowToolTips – False
      Tooltips für Tabs aktivieren ImageList – $null
      Ermöglicht Icons in Tabs SelectedImageIndex – -1
      Index des Icons fürenthält den aktiveneigentlichen TabInhalt


      TabControl erstellen

      # Klassisch
$tabControl = New-Object System.Windows.Forms.TabControl

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

      Tab hinzufügen / entfernen

      # Hinzufügen
$tabControl.TabPages.Add($tabPage1)
$tabControl.TabPages.Add("Mein Tab") # erstellt TabPage (nur Text)
$tabControl.TabPages.Add("Name", "Text") # Name + Text
$tabControl.TabPages.AddRange(@($tabPage2, $tabPage3))
$tabControl.TabPages.Insert(0, $tabPage4)

# Entfernen
$tabControl.TabPages.Remove($tabPage1)
$tabControl.TabPages.RemoveAt(0)
$tabControl.TabPages.Clear()

# technisch möglich, aber nicht empfohlen
$tabControl.Controls.Add($tabPage4)
$tabControl.Controls.AddRange(@($tabPage5, $tabPage6))
$tabControl.Controls.Remove($tabPage2)
$tabControl.Controls.RemoveRange(@($tabPage3, $tabPage4))

      Tab-Auswahl

      # Zugriff auf einzelnes TabPage
$tabControl.TabPages[0]

# Aktiven Tab setzen
$tabControl.SelectedIndex = 0
$tabControl.SelectedTab = $tabPage1

      Events - TabControl

      $tabControl.Add_*
  param($sender, $e)
      • $sender → Das TabControl selbst (=$this)
      • $e (EventArgs) → Argumente Tab (TabPage) entsprechend

      Selecting / Selected

      Selecting
      Vor dem Wechsel zu einem Tab (TabPage) → kann noch abgebrochen werden

      • $e.TabPage → der Tab, zu dem gewechselt werden soll
      • $e.TabPageIndex → Index davon
      • $e.Cancel → kannst du auf $true setzen → Wechsel wird verhindert

      Selected
      Nach dem Wechsel zu einem Tab (TabPage)

      • $e.TabPage → der Tab, zu dem gewechselt wurde
      • $e.TabPageIndex → Index davon
      $tabControl.Add_Selecting({
    param($sender, $e)

    # Ziel-Tab
    $nextTab = $e.TabPage

    if ($nextTab.Name -eq "PackageTab") {
        Write-Host "Wechsel verhindert!"

        # 🚨 DAS ist der Trick:
        $e.Cancel = $true
    }
})

      SelectedIndexChanged

      Beim Wechsel des Tabs (TabPages)

      • ❌$e.TabPage → hier ist es $sender.SelectedTab
      • $sender.SelectedTab → der aktuell ausgewählte Tab
      $tabControl.Add_Selecting({
    param($sender, $e)

    # Ziel-Tab
    $nextTab = $e.TabPage

    if ($nextTab.Name -eq "PackageTab") {
        Write-Host "Wechsel verhindert!"

        # 🚨 DAS ist der Trick:
        $e.Cancel = $true
    }
})

      Deselecting / Deselected

      Deselecting
      Vor dem Verlassen eines Tabs (TabPage) → kann noch abgebrochen werden

      $tabControl.Add_Deselecting({
    param($sender, $e)

    # Aktueller Tab (der verlassen wird)
    $currentTab = $e.TabPage

    # Beispiel: Verhindere Verlassen wenn noch Auswahl vorhanden
    if ($currentTab.Name -eq "PackageTab" -and $checkedListBox.CheckedItems.Count -gt 0) {
        Write-Host "Du hast noch Auswahl!"

        $e.Cancel = $true
    }
})

      $e (EventArgs)
      •       $e.TabPage → der Tab, der verlassen wird
      • $e.Cancel → $true = Wechsel wird verhindert

      Deselected
      Nach dem Verlassen eines Tabs → ideal zum Zurücksetzen von UI

      $tabControl.Add_Deselected({
    param($sender, $e)

    # Verlassener Tab
    $oldTab = $e.TabPage

    if ($oldTab.Name -eq "PackageTab") {

        # CheckedListBox zurücksetzen
        for ($i = 0; $i -lt $checkedListBox.Items.Count; $i++) {
            $checkedListBox.SetItemChecked($i, $false)
        }

        # ListBox zurücksetzen
        $listBox.ClearSelected()
    }
})

      $e (EventArgs)
      •       $e.TabPage → der Tab, der verlassen wurde

      Click

      Klick auf das Control (selten relevant)

      ControlAdded / ControlRemoved

      Wenn TabPages hinzugefügt oder entfernt werden

      Tipps & Tricks - TabControl

      Typische Stolperfallen

      • Tab wird nicht angezeigt
        → nicht zur TabPages-Collection hinzugefügt
      • Events greifen nicht
        → falsches Event verwendet (Selecting vs. SelectedIndexChanged)
      • Layout wirkt falsch
        → Dock / Anchor nicht sauber gesetzt
      • Icons fehlen
        → ImageList nicht gesetzt oder falscher Index

      Mentales Modell

      Das TabControl ist ein Container mit Umschalter-Logik.

      Es zeigt genau eine TabPage gleichzeitig
      und verwaltet nur, welche sichtbar ist.

      Wann sinnvoll?

      • Strukturierung komplexer Inhalte
      • Einstellungen / Optionen
      • Platz sparen

      Wann vermeiden?

      • Häufiges Hin- und Herspringen notwendig
      • Linearer Workflow
      • Stark voneinander abhängige Inhalte
      Back to top