AutoSize

Typ = [System.Boolean]

Der Wert von AutoSize legt fest, ob sich die Größe des Buttons automatisch an dessen Inhalt anpasst. Standardmäßig besitzt diese Eigenschaft den Wert False, wodurch ausschließlich die Eigenschaft Size die Größe bestimmt.

Ist AutoSize auf True gesetzt, wird die Breite und Höhe des Buttons automatisch an den enthaltenen Text beziehungsweise das Bild angepasst.

$button.AutoSize = $true

AutoEllipsis

Typ = [System.Boolean]

Der Wert von AutoEllipsis legt fest, ob zu langer Text automatisch mit ... gekürzt werden soll, wenn dieser nicht vollständig dargestellt werden kann.

Standardmäßig ist diese Eigenschaft auf False gesetzt.

$button.AutoEllipsis = $true

BackColor

Typ = [System.Drawing.Color]

Der Wert von BackColor legt die Hintergrundfarbe des Buttons fest.

Standardmäßig wird die Hintergrundfarbe durch das aktuelle Windows-Design bestimmt. Soll eine eigene Hintergrundfarbe verwendet werden, muss zusätzlich UseVisualStyleBackColor auf $false gesetzt werden.

$button.UseVisualStyleBackColor = $false
$button.BackColor = "RoyalBlue"

💡 Hinweis
Solange UseVisualStyleBackColor aktiviert ist, wird BackColor häufig ignoriert.

DialogResult

Typ = [System.Windows.Forms.DialogResult]

Der Wert von DialogResult legt fest, welcher Rückgabewert beim Anklicken des Buttons an ein modales Dialogfenster (ShowDialog()) zurückgegeben wird.

Standardmäßig besitzt diese Eigenschaft den Wert None. Wird beispielsweise OK, Cancel oder Yes festgelegt, schließt sich das Dialogfenster automatisch und ShowDialog() liefert den entsprechenden Wert zurück.

Diese Eigenschaft wird hauptsächlich in Dialogfenstern verwendet.

$button.DialogResult = "OK"

Dock

Typ = [System.Windows.Forms.DockStyle]

Der Wert von Dock legt fest, an welcher Seite seines Parent-Containers der Button angedockt wird. Standardmäßig besitzt diese Eigenschaft den Wert None, wodurch Position und Größe ausschließlich über Location und Size bestimmt werden.

Alternativ kann der Button am oberen (Top), unteren (Bottom), linken (Left) oder rechten (Right) Rand angedockt oder mit Fill über den gesamten verfügbaren Bereich ausgedehnt werden.

Im Gegensatz zu Anchor übernimmt Dock sowohl die Positionierung als auch die Größenanpassung des Controls.

$button.Dock = "Fill"

Enabled

Typ = [System.Boolean]

Der Wert von Enabled legt fest, ob der Button vom Benutzer verwendet werden kann.

Standardmäßig besitzt diese Eigenschaft den Wert True. Ist sie auf False gesetzt, wird der Button ausgegraut dargestellt und reagiert weder auf Maus- noch auf Tastatureingaben.

$button.Enabled = $false

FlatAppearance

Typ = [System.Windows.Forms.FlatButtonAppearance]

Der Wert von FlatAppearance enthält verschiedene Eigenschaften zur Darstellung eines Buttons mit dem FlatStyle Flat oder Popup.

Hierüber können unter anderem die Rahmenfarbe (BorderColor), Rahmenstärke (BorderSize) sowie die Hintergrundfarben beim Überfahren oder Anklicken angepasst werden.

$button.FlatStyle = "Flat"

$button.FlatAppearance.BorderSize = 1
$button.FlatAppearance.BorderColor = "DodgerBlue"

💡 Hinweis
Die Eigenschaften von FlatAppearance wirken nur bei den Darstellungsarten Flat und teilweise Popup.

FlatStyle

Typ = [System.Windows.Forms.FlatStyle]

Der Wert von FlatStyle bestimmt das Erscheinungsbild des Buttons.

Standardmäßig besitzt diese Eigenschaft den Wert Standard. Alternativ stehen Flat, Popup und System zur Verfügung.

• Standard → Standarddarstellung

• Flat → flacher Button

• Popup → flach, hebt sich beim Überfahren hervor

• System → Darstellung vollständig durch Windows

$button.FlatStyle = "Flat"

Font

Typ = [System.Drawing.Font]

Der Wert von Font legt die Schriftart fest, mit der der Text des Buttons dargestellt wird.

Änderungen an dieser Eigenschaft beeinflussen sowohl Schriftart als auch Schriftgröße und Schriftstil.

$button.Font = [System.Drawing.Font]::new( "Segoe UI", 10, "Bold" )

ForeColor

Typ = [System.Drawing.Color]

Der Wert von ForeColor legt die Farbe fest, mit der der Text des Buttons dargestellt wird.

$button.ForeColor = "White"

Image

Typ = [System.Drawing.Image]

Der Wert von Image legt das Bild fest, das auf dem Button angezeigt werden soll.

Standardmäßig besitzt diese Eigenschaft den Wert $null, wodurch kein Bild dargestellt wird. Ist sowohl ein Bild als auch ein Text vorhanden, bestimmt TextImageRelation, wie beide Elemente zueinander angeordnet werden.

$button.Image = [System.Drawing.Image]::FromFile( "C:\Icons\Save.png" )

💡 Hinweis
Soll das Bild aus einer ImageList stammen, werden stattdessen die Eigenschaften ImageList sowie ImageIndex oder ImageKey verwendet.

ImageAlign

Typ = [System.Drawing.ContentAlignment]

Der Wert von ImageAlign legt fest, an welcher Position das Bild innerhalb des Buttons dargestellt wird.

Standardmäßig befindet sich das Bild mittig (MiddleCenter). Zusammen mit TextAlign und TextImageRelation lässt sich die Anordnung von Bild und Text individuell festlegen.

$button.ImageAlign = "MiddleLeft"

ImageIndex

Typ = [System.Int32]

Der Wert von ImageIndex bestimmt den Index des Bildes innerhalb der zugewiesenen ImageList.

Standardmäßig besitzt diese Eigenschaft den Wert -1, wodurch kein Bild ausgewählt ist.

$button.ImageList = $imageList
$button.ImageIndex = 0

💡 Hinweis
ImageIndex und ImageKey dienen demselben Zweck. Es sollte immer nur eine der beiden Eigenschaften verwendet werden.

ImageKey

Typ = [System.String]

Der Wert von ImageKey legt den Namen eines Bildes innerhalb der zugewiesenen ImageList fest.

Im Gegensatz zu ImageIndex erfolgt die Auswahl hierbei über den Namen des Bildes.

$button.ImageList = $imageList
$button.ImageKey = "Save"

ImageList

Typ = [System.Windows.Forms.ImageList]

Der Wert von ImageList legt die Bildersammlung fest, aus der der Button seine Bilder beziehen kann.

Die Eigenschaft selbst bestimmt noch kein Bild. Welches Bild angezeigt wird, wird anschließend über ImageIndex oder ImageKey ausgewählt.

$button.ImageList = $imageList
$button.ImageIndex = 2

Location

Typ = [System.Drawing.Point]

Der Wert von Location legt die Position des Buttons innerhalb seines Parent-Containers fest.

Die Position wird über die X- und Y-Koordinate relativ zum Parent-Control angegeben.

$button.Location = "20, 40"

💡 Hinweis
Ist zusätzlich Dock aktiviert, wird Location vom Layoutsystem automatisch verwaltet.

Margin

Typ = [System.Windows.Forms.Padding]

Der Wert von Margin legt den äußeren Abstand des Buttons zu benachbarten Controls fest.

Die Eigenschaft wird hauptsächlich von Layout-Containern wie FlowLayoutPanel oder TableLayoutPanel berücksichtigt.

$button.Margin = [System.Windows.Forms.Padding]::new(10)

MaximumSize

Typ = [System.Drawing.Size]

Der Wert von MaximumSize legt die maximal zulässige Größe des Buttons fest.

Standardmäßig besitzt diese Eigenschaft den Wert (0,0). Dadurch existiert keine Größenbegrenzung.

$button.MaximumSize = "250, 50"

MinimumSize

Typ = [System.Drawing.Size]

Der Wert von MinimumSize legt die minimal zulässige Größe des Buttons fest.

Unterschreitet eine Größenänderung diesen Wert, bleibt die festgelegte Mindestgröße erhalten.

$button.MinimumSize = "120, 35"

Name

Typ = [System.String]

Der Wert von Name legt den internen Namen des Buttons fest.

Der Name dient ausschließlich der Identifikation innerhalb des Programms und wird dem Benutzer nicht angezeigt. Besonders bei größeren Formularen erleichtert ein eindeutiger Name die spätere Verwaltung und den Zugriff auf Controls.

$button.Name = "btnSave"

Padding

Typ = [System.Windows.Forms.Padding]

Der Wert von Padding legt den Innenabstand zwischen dem Rand des Buttons und dessen Inhalt fest.

Dadurch kann zusätzlicher Abstand zwischen Rahmen, Text und Bild geschaffen werden.

$button.Padding = [System.Windows.Forms.Padding]::new(8)

Size

Typ = [System.Drawing.Size]

Der Wert von Size legt die Breite und Höhe des Buttons fest.

Standardmäßig wird die Größe ausschließlich durch diese Eigenschaft bestimmt. Ist AutoSize aktiviert, kann die Größe automatisch anhand des Inhalts berechnet werden.

$button.Size = "120, 35"

TabIndex

Typ = [System.Int32]

Der Wert von TabIndex legt die Reihenfolge fest, in der das Control den Fokus erhält, wenn der Benutzer die Tabulator-Taste betätigt.

Standardmäßig vergibt der Designer beziehungsweise die Reihenfolge der hinzugefügten Controls fortlaufende Werte. Das Control mit dem kleinsten TabIndex erhält den Fokus zuerst.

$button.TabIndex = 2

💡 Hinweis
Die tatsächliche Tabulator-Reihenfolge ergibt sich aus dem Zusammenspiel von TabIndex und TabStop.

TabStop

Typ = [System.Boolean]

Der Wert von TabStop legt fest, ob der Button über die Tabulator-Taste den Fokus erhalten kann.

Standardmäßig besitzt diese Eigenschaft den Wert True. Wird sie auf False gesetzt, überspringt die Tabulator-Navigation den Button, obwohl dieser weiterhin per Mausklick verwendet werden kann.

$button.TabStop = $false

Text

Typ = [System.String]

Der Wert von Text legt die sichtbare Beschriftung des Buttons fest.

Standardmäßig besitzt diese Eigenschaft den Wert "" (leerer String). Der Text wird innerhalb des Buttons entsprechend der Eigenschaft TextAlign dargestellt.

$button.Text = "Speichern"

Soll der Button ausschließlich ein Symbol enthalten, kann der Text leer bleiben.

$button.Text = ""

TextAlign

Typ = [System.Drawing.ContentAlignment]

Der Wert von TextAlign legt fest, an welcher Position der Text innerhalb des Buttons dargestellt wird.

Standardmäßig besitzt diese Eigenschaft den Wert MiddleCenter, wodurch der Text zentriert angezeigt wird.

In Kombination mit ImageAlign und TextImageRelation kann die Position von Text und Bild unabhängig voneinander festgelegt werden.

$button.TextAlign = "MiddleRight"

TextImageRelation

Typ = [System.Windows.Forms.TextImageRelation]

Der Wert von TextImageRelation legt fest, wie Text und Bild innerhalb des Buttons zueinander angeordnet werden.

Diese Eigenschaft besitzt nur dann eine sichtbare Auswirkung, wenn sowohl Text als auch Image beziehungsweise ImageList verwendet werden.

Folgende Werte stehen zur Verfügung:

• Overlay → Text und Bild liegen übereinander

• ImageBeforeText → Bild links vom Text

• TextBeforeImage → Text links vom Bild

• ImageAboveText → Bild oberhalb des Textes

• TextAboveImage → Text oberhalb des Bildes

$button.Image = $image
$button.Text = "Speichern"

$button.TextImageRelation = "ImageBeforeText"

💡 Hinweis
Die genaue Position wird zusätzlich durch ImageAlign und TextAlign beeinflusst.

UseMnemonic

Typ = [System.Boolean]

Der Wert von UseMnemonic legt fest, ob im Text enthaltene Mnemonics ausgewertet werden.

Standardmäßig besitzt diese Eigenschaft den Wert True.

Ein kaufmännisches Und (&) kennzeichnet den folgenden Buchstaben als Tastenkombination. Dieser Buchstabe wird unterstrichen und kann zusammen mit der Alt-Taste verwendet werden.

$button.Text = "&Speichern"

Im Beispiel kann der Button mit Alt + S aktiviert werden.

Soll das Zeichen & hingegen als normales Zeichen dargestellt werden, muss es doppelt angegeben werden.

$button.Text = "Speichern && Schließen"

UseVisualStyleBackColor

Typ = [System.Boolean]

Der Wert von UseVisualStyleBackColor legt fest, ob der Button seine Hintergrundfarbe vom aktuellen Windows-Design übernimmt.

Standardmäßig besitzt diese Eigenschaft den Wert True. Dadurch bestimmt Windows die Darstellung des Buttons, wodurch eine einheitliche Optik mit dem Betriebssystem erreicht wird.

Soll eine eigene Hintergrundfarbe über BackColor verwendet werden, muss UseVisualStyleBackColor auf $false gesetzt werden.

$button.UseVisualStyleBackColor = $false
$button.BackColor = "RoyalBlue"

💡 Hinweis
Solange UseVisualStyleBackColor aktiviert ist, wird BackColor häufig vollständig ignoriert.

Visible

Typ = [System.Boolean]

Der Wert von Visible legt fest, ob der Button sichtbar dargestellt wird.

Standardmäßig besitzt diese Eigenschaft den Wert True. Wird sie auf False gesetzt, wird der Button nicht angezeigt und kann weder per Maus noch per Tastatur verwendet werden.

$button.Visible = $false

Die Eigenschaft eignet sich insbesondere, um Bedienelemente abhängig vom Programmzustand ein- oder auszublenden.

$button.Visible = $userIsAdmin

PerformClick()

$button.PerformClick()

Beschreibung

Die Methode PerformClick() löst programmgesteuert einen Klick auf den Button aus.
Dabei wird das Click-Event genauso ausgelöst, als hätte der Benutzer den Button mit der Maus angeklickt. Dadurch kann dieselbe Programmlogik sowohl durch Benutzereingaben als auch durch Code ausgeführt werden.
Die Methode führt den Klick nur aus, wenn der Button aktiviert (Enabled = $true) und sichtbar (Visible = $true) ist.

Rückgabe

Keine Rückgabe System.Void

Beispiel

$button.Add_Click({
    Write-Host "Button wurde geklickt."
})

# Klick per Code auslösen
$button.PerformClick()

Select()

$button.Select()

Beschreibung

Die Methode Select() versucht, den Eingabefokus auf den Button zu setzen.
Der Button erhält den Fokus jedoch nur, wenn er aktiviert (Enabled = $true), sichtbar (Visible = $true) und innerhalb seines Parent-Containers auswählbar ist.
Nach erfolgreichem Aufruf kann der Button beispielsweise direkt über die Leertaste oder Eingabetaste ausgelöst werden.

Rückgabe

Keine Rückgabe System.Void

Beispiel

$button.Select()

Focus()

$button.Focus()

Beschreibung

Die Methode Focus() versucht, den Tastaturfokus auf den Button zu setzen.
Im Gegensatz zu Select() liefert die Methode einen Rückgabewert, anhand dessen überprüft werden kann, ob das Setzen des Fokus erfolgreich war.
Die Methode schlägt beispielsweise fehl, wenn der Button deaktiviert oder nicht sichtbar ist.

Rückgabe

Gibt True zurück, wenn der Fokus erfolgreich gesetzt werden konnte, andernfalls False. 

Rückgabetyp: System.Boolean

Beispiel

if ($button.Focus()) {
    Write-Host "Button besitzt jetzt den Fokus."
}
else {
    Write-Host "Fokus konnte nicht gesetzt werden."
}

BringToFront()

$button.BringToFront()

Die Methode BringToFront() bringt den Button innerhalb seines Parent-Containers in die vorderste Ebene der Z-Reihenfolge.

Dies ist insbesondere relevant, wenn sich mehrere Controls überlappen. Der Button wird dadurch vor anderen Controls desselben Parent-Containers dargestellt.

Die Methode verändert weder die Position (Location) noch die Größe (Size) des Buttons.

Keine Rückgabe System.Void

$button.BringToFront()

SendToBack()

$button.SendToBack()

 Beschreibung

Die Methode SendToBack() verschiebt den Button innerhalb seines Parent-Containers in die hinterste Ebene der Z-Reihenfolge.

Dies ist insbesondere relevant, wenn sich mehrere Controls überlappen. Der Button wird dadurch hinter anderen Controls desselben Parent-Containers dargestellt.

Die Methode verändert weder die Position (Location) noch die Größe (Size) des Buttons.

Keine Rückgabe System.Void

$button.SendToBack()

Click

Das Click-Event wird ausgelöst, wenn der Benutzer den Button anklickt oder dieser programmgesteuert über PerformClick() ausgelöst wird.

Dies ist das am häufigsten verwendete Event eines Buttons und dient üblicherweise zum Ausführen einer Aktion.

Beispiel

$button.Add_Click({
    Write-Host "Speichern..."
})

DoubleClick

Das DoubleClick-Event wird ausgelöst, wenn der Benutzer den Button doppelt anklickt.

Da Buttons normalerweise bereits auf den ersten Klick reagieren, wird dieses Event nur selten verwendet.

Beispiel

$button.Add_DoubleClick({
    Write-Host "Doppelklick"
})

MouseClick

Das MouseClick-Event wird ausgelöst, wenn der Benutzer den Button mit einer Maustaste anklickt.

Im Gegensatz zum Click-Event stehen zusätzliche Informationen zur verwendeten Maustaste sowie zur Mausposition zur Verfügung.

Beispiel

$button.Add_MouseClick({
    param($sender, $e)

    Write-Host "Taste    : $($e.Button)"
    Write-Host "Klicks   : $($e.Clicks)"
    Write-Host "X        : $($e.X)"
    Write-Host "Y        : $($e.Y)"
    Write-Host "Position : $($e.Location)"
})

Ausgabe

Taste    : Left
Klicks   : 1
X        : 84
Y        : 17
Position : {X=84,Y=17}

$button.Add_MouseClick({
    param($sender, $e)

    Write-Host $e.Button
})

MouseDown

Das MouseDown-Event wird ausgelöst, sobald der Benutzer eine Maustaste auf dem Button drückt.

Dieses Event eignet sich beispielsweise zum Starten von Drag-and-Drop-Operationen oder zum Erfassen der gedrückten Maustaste.

Beispiel

$button.Add_MouseDown({
    param($sender, $e)

    Write-Host "Taste gedrückt."
})

MouseUp

Das MouseUp-Event wird ausgelöst, sobald eine gedrückte Maustaste wieder losgelassen wird.

Beispiel

$button.Add_MouseUp({
    Write-Host "Taste losgelassen."
})

MouseEnter

Das MouseEnter-Event wird ausgelöst, wenn sich der Mauszeiger erstmals über dem Button befindet.

Es wird häufig verwendet, um beispielsweise Informationen einzublenden oder das Aussehen eines Controls zu verändern.

Beispiel

$button.Add_MouseEnter({
    $button.BackColor = "LightBlue"
})

MouseLeave

Das MouseLeave-Event wird ausgelöst, wenn der Mauszeiger den Button wieder verlässt.

Beispiel

$button.Add_MouseLeave({
    $button.BackColor = "White"
})

MouseMove

Das MouseMove-Event wird fortlaufend ausgelöst, während sich der Mauszeiger innerhalb des Buttons bewegt.

Über die Ereignisparameter können die aktuellen Mauskoordinaten abgefragt werden.

Beispiel

$button.Add_MouseMove({
    param($sender, $e)

    Write-Host "$($e.X), $($e.Y)"
})

GotFocus

Das GotFocus-Event wird ausgelöst, sobald der Button den Tastaturfokus erhält.

Beispiel

$button.Add_GotFocus({
    Write-Host "Button besitzt den Fokus."
})

LostFocus

Das LostFocus-Event wird ausgelöst, wenn der Button den Tastaturfokus verliert.

Beispiel

$button.Add_LostFocus({
    Write-Host "Fokus verloren."
})

KeyDown

Das KeyDown-Event wird ausgelöst, sobald eine Taste gedrückt wird, während der Button den Fokus besitzt.

Beispiel

$button.Add_KeyDown({
    param($sender, $e)

    if ($e.KeyCode -eq "Enter") {
        Write-Host "Enter"
    }
})

KeyPress

Das KeyPress-Event wird ausgelöst, wenn ein druckbares Zeichen eingegeben wird.

Es eignet sich insbesondere zur Verarbeitung einzelner Zeichen.

Beispiel

$button.Add_KeyPress({
    param($sender, $e)

    Write-Host $e.KeyChar
})

KeyUp

Das KeyUp-Event wird ausgelöst, sobald eine gedrückte Taste wieder losgelassen wird.

Beispiel

$button.Add_KeyUp({
    Write-Host "Taste losgelassen."
})

AutoEllipsis

Typ = [System.Boolean]

Der Wert von AutoEllipsis legt fest, ob zu langer Text automatisch mit ... gekürzt werden soll, wenn dieser nicht vollständig dargestellt werden kann.

Standardmäßig ist diese Eigenschaft auf False gesetzt.

$label.AutoEllipsis = $true

💡 Hinweis AutoEllipsis ist insbesondere dann sinnvoll, wenn die Größe des Labels begrenzt ist und der vollständige Text nicht angezeigt werden kann.

AutoSize

Typ = [System.Boolean]

Der Wert von AutoSize legt fest, ob sich die Größe des Labels automatisch an dessen Inhalt anpasst.

Beim Label ist AutoSize standardmäßig auf True gesetzt.

Dadurch wird die Größe automatisch anhand des enthaltenen Textes beziehungsweise Bildes bestimmt.

$label.AutoSize = $true

Soll das Label eine feste Größe besitzen, kann AutoSize deaktiviert werden.

$label.AutoSize = $false
$label.Size = "200, 40"

BackColor

Typ = [System.Drawing.Color]

Der Wert von BackColor legt die Hintergrundfarbe des Labels fest.

$label.BackColor = "LightBlue"

Standardmäßig übernimmt das Label die Hintergrundfarbe seines Parent-Controls beziehungsweise die von Windows vorgegebene Standardfarbe.

BorderStyle

Typ = [System.Windows.Forms.BorderStyle]

Der Wert von BorderStyle bestimmt, ob und wie ein Rahmen um das Label dargestellt wird.

Folgende Werte stehen zur Verfügung:

• None → kein Rahmen
• FixedSingle → einfacher Rahmen
• Fixed3D → dreidimensionaler Rahmen

Standardmäßig besitzt diese Eigenschaft den Wert None.

$label.BorderStyle = "FixedSingle"

Cursor

Typ = [System.Windows.Forms.Cursor]

Der Wert von Cursor legt fest, welcher Mauszeiger angezeigt wird, wenn sich der Mauszeiger über dem Label befindet.

$label.Cursor = [System.Windows.Forms.Cursors]::Hand

Dies kann beispielsweise verwendet werden, wenn das Label wie ein anklickbarer Link verwendet wird.

Dock

Typ = [System.Windows.Forms.DockStyle]

Der Wert von Dock legt fest, an welcher Seite seines Parent-Containers das Label angedockt wird.

Standardmäßig besitzt diese Eigenschaft den Wert None.

$label.Dock = "Top"

Alternativ kann das Label mit Fill den gesamten verfügbaren Bereich einnehmen.

$label.Dock = "Fill"

Im Gegensatz zu Anchor übernimmt Dock sowohl die Positionierung als auch die Größenanpassung des Controls.

Enabled

Typ = [System.Boolean]

Der Wert von Enabled legt fest, ob das Label aktiviert ist.

Standardmäßig besitzt diese Eigenschaft den Wert True.

Wird Enabled auf False gesetzt, wird das Label deaktiviert dargestellt und reagiert nicht mehr auf Eingaben.

$label.Enabled = $false

💡 Hinweis Bei einem gewöhnlichen Label betrifft Enabled hauptsächlich die Darstellung. Ein Label ist standardmäßig ohnehin nicht über die Tabulator-Navigation fokussierbar.

FlatStyle

Typ = [System.Windows.Forms.FlatStyle]

Der Wert von FlatStyle bestimmt die Darstellungsart des Labels.

Folgende Werte stehen zur Verfügung:

• Flat → flache Darstellung
• Popup → flache Darstellung mit Hervorhebung bei Interaktion
• Standard → Standarddarstellung
• System → Darstellung durch Windows

$label.FlatStyle = "Flat"

Font

Typ = [System.Drawing.Font]

Der Wert von Font legt die Schriftart fest, mit der der Text des Labels dargestellt wird.

Änderungen an dieser Eigenschaft beeinflussen Schriftart, Schriftgröße und Schriftstil.

$label.Font = [System.Drawing.Font]::new(
    "Segoe UI",
    10,
    "Bold"
)

ForeColor

Typ = [System.Drawing.Color]

Der Wert von ForeColor legt die Farbe fest, mit der der Text des Labels dargestellt wird.

$label.ForeColor = "White"

Image

Typ = [System.Drawing.Image]

Der Wert von Image legt das Bild fest, das im Label angezeigt werden soll.

$label.Image = [System.Drawing.Image]::FromFile(
    "C:\Icons\Info.png"
)

Ist gleichzeitig Text vorhanden, bestimmt TextAlign beziehungsweise ImageAlign, wie die Inhalte innerhalb des Labels positioniert werden.

ImageAlign

Typ = [System.Drawing.ContentAlignment]

Der Wert von ImageAlign legt fest, an welcher Position das Bild innerhalb des Labels dargestellt wird.

$label.ImageAlign = "MiddleCenter"

ImageIndex

Typ = [System.Int32]

Der Wert von ImageIndex bestimmt den Index des Bildes innerhalb der zugewiesenen ImageList.

Standardmäßig ist kein Bild ausgewählt.

$label.ImageList = $imageList
$label.ImageIndex = 0

💡 Hinweis ImageIndex und ImageKey dienen demselben Zweck. Es sollte immer nur eine der beiden Eigenschaften verwendet werden.

ImageKey

Typ = [System.String]

Der Wert von ImageKey legt den Namen eines Bildes innerhalb der zugewiesenen ImageList fest.

$label.ImageList = $imageList
$label.ImageKey = "Info"

Im Gegensatz zu ImageIndex erfolgt die Auswahl über den Namen des Bildes.

ImageList

Typ = [System.Windows.Forms.ImageList]

Der Wert von ImageList legt die Bildersammlung fest, aus der das Label ein Bild beziehen kann.

Welche Grafik verwendet wird, wird anschließend über ImageIndex oder ImageKey bestimmt.

$label.ImageList = $imageList
$label.ImageIndex = 0

Location

Typ = [System.Drawing.Point]

Der Wert von Location legt die Position des Labels innerhalb seines Parent-Containers fest.

Die Position wird über die X- und Y-Koordinate relativ zum Parent-Control angegeben.

$label.Location = "20, 40"

💡 Hinweis Wird das Label durch einen Layout-Container oder Dock positioniert, wird Location vom Layoutsystem verwaltet.

Margin

Typ = [System.Windows.Forms.Padding]

Der Wert von Margin legt den äußeren Abstand des Labels zu benachbarten Controls fest.

Die Eigenschaft wird insbesondere von Layout-Containern wie FlowLayoutPanel oder TableLayoutPanel berücksichtigt.

$label.Margin = [System.Windows.Forms.Padding]::new(10)

MaximumSize

Typ = [System.Drawing.Size]

Der Wert von MaximumSize legt die maximal zulässige Größe des Labels fest.

Standardmäßig besitzt diese Eigenschaft den Wert (0,0). Dadurch existiert keine Größenbegrenzung.

$label.MaximumSize = "300, 100"

MinimumSize

Typ = [System.Drawing.Size]

Der Wert von MinimumSize legt die minimal zulässige Größe des Labels fest.

$label.MinimumSize = "100, 25"

Name

Typ = [System.String]

Der Wert von Name legt den internen Namen des Labels fest.

Der Name dient ausschließlich der Identifikation innerhalb des Programms und wird dem Benutzer nicht angezeigt.

$label.Name = "lblUsername"

Padding

Typ = [System.Windows.Forms.Padding]

Der Wert von Padding legt den Innenabstand zwischen dem Rand des Labels und dessen Inhalt fest.

$label.Padding = [System.Windows.Forms.Padding]::new(8)

Size

Typ = [System.Drawing.Size]

Der Wert von Size legt die Breite und Höhe des Labels fest.

$label.Size = "200, 35"

Ist AutoSize aktiviert, kann die Größe automatisch anhand des Inhalts angepasst werden.

TabIndex

Typ = [System.Int32]

Der Wert von TabIndex legt die Reihenfolge fest, in der das Label den Fokus erhält, wenn der Benutzer die Tabulator-Taste betätigt.

Standardmäßig besitzt ein Label einen TabIndex, obwohl es normalerweise nicht über die Tabulator-Navigation fokussiert werden kann.

$label.TabIndex = 2

💡 Hinweis TabIndex wird beim Label erst relevant, wenn TabStop auf True gesetzt wird.

TabStop

Typ = [System.Boolean]

Der Wert von TabStop legt fest, ob das Label über die Tabulator-Taste den Fokus erhalten kann.

Beim Label ist diese Eigenschaft standardmäßig auf False gesetzt.

$label.TabStop = $true

Dadurch kann das Label Teil der Tabulator-Navigation werden.

💡 Hinweis Ein gewöhnliches Label ist kein interaktives Eingabeelement. Deshalb ist TabStop standardmäßig deaktiviert.

Text

Typ = [System.String]

Der Wert von Text legt den sichtbaren Text des Labels fest.

$label.Text = "Benutzername:"

Standardmäßig besitzt diese Eigenschaft den Wert "" (leerer String).

TextAlign

Typ = [System.Drawing.ContentAlignment]

Der Wert von TextAlign legt fest, an welcher Position der Text innerhalb des Labels dargestellt wird.

$label.TextAlign = "MiddleCenter"

Dadurch wird der Text sowohl horizontal als auch vertikal zentriert.

UseCompatibleTextRendering

Typ = [System.Boolean]

Der Wert von UseCompatibleTextRendering bestimmt, welche Textdarstellung für das Label verwendet wird.

Bei False wird die neuere GDI-basierte Textdarstellung verwendet. Bei True wird die ältere GDI+-basierte Darstellung verwendet.

$label.UseCompatibleTextRendering = $true

Die Eigenschaft ist hauptsächlich für Kompatibilität mit älteren Anwendungen relevant.

💡 Hinweis In den meisten Fällen kann der Standardwert verwendet werden. Die Eigenschaft wird insbesondere dann interessant, wenn Unterschiede bei der Textdarstellung, beispielsweise bei Zeilenumbruch oder Schriftmessung, auftreten.

UseMnemonic

Typ = [System.Boolean]

Der Wert von UseMnemonic legt fest, ob das Zeichen & im Text zur Definition eines Tastaturkürzels verwendet wird.

Ist die Eigenschaft aktiviert, wird das Zeichen direkt vor einem Buchstaben als Kennzeichnung für eine Mnemonic-Taste interpretiert.

$label.Text = "&Name:"
$label.UseMnemonic = $true

Das N kann dadurch als Zugriffstaste verwendet werden.

Soll das Zeichen & tatsächlich angezeigt werden, kann es durch && maskiert werden.

$label.Text = "Speichern && Beenden"

Visible

Typ = [System.Boolean]

Der Wert von Visible legt fest, ob das Label sichtbar ist.

Standardmäßig besitzt diese Eigenschaft den Wert True.

$label.Visible = $false

Wird die Eigenschaft auf False gesetzt, wird das Label ausgeblendet.

• Property – Standardwert
  Beschreibung oder Erläuterung der Eigenschaft

• BackColor – SystemColors.Window
  Hintergrundfarbe der RichTextBox

• BorderStyle – Fixed3D
  Rahmenstil (None, FixedSingle, Fixed3D)

• Font – Standard-Systemfont
  Schriftart und -größe

• ForeColor – SystemColors.WindowText
  Textfarbe

• HideSelection – $true
  Steuert, ob der Text im nicht markierten Zustand verborgen wird

• Text – ""
  Der gesamte Text in der RichTextBox

• WordWrap – $true
  Zeilenumbruch aktivieren/deaktivieren

• Rtf – ""
  Ruft den RTF-Inhalt der RichTextBox ab oder setzt ihn

• Multiline – $true
  Zeigt Text auf mehreren Zeilen

• SelectionAlignment – Left
  Ausrichtung des Textes in der aktuellen Auswahl (Left, Center, Right)

• SelectionColor – SystemColors.HighlightText
  Farbe der ausgewählten Textstellen

• SelectionFont – Standard-Schrift
  Schriftart der Auswahl

• SelectionBackColor – SystemColors.Highlight
  Hintergrundfarbe der Auswahl

• SelectionLength – 0
  Länge der aktuellen Auswahl

• SelectionStart – 0
  Der Startindex der aktuellen Auswahl

• TextChanged – $false
  Event wird ausgelöst, wenn sich der Text ändert

• Property – Standardwert
  Beschreibung oder Erläuterung der Eigenschaft

• Appearance – Normal
  Darstellung der CheckBox
  Normal = klassische Checkbox
  Button = verhält sich wie ein Toggle-Button

• AutoCheck – $true
  Ob die CheckBox ihren Zustand automatisch selbst ändert

• Checked – $false
  Ob die CheckBox aktiviert ist

• CheckState – Unchecked
  Zustand der CheckBox
  (Unchecked, Checked, Indeterminate)

• ThreeState – $false
  Erlaubt dritten Zustand (Indeterminate)

• Text – ""
  Angezeigter Text neben der Checkbox

• TextAlign – MiddleLeft
  Ausrichtung des Textes

• CheckAlign – MiddleLeft
  Position des Häkchens

• FlatStyle – Standard
  Darstellung der Checkbox
  (Standard, Flat, Popup, System)

• AutoSize – $false
  Passt Größe automatisch an Inhalt an

• Enabled – $true
  Aktiviert oder deaktiviert die CheckBox

• Visible – $true
  Sichtbarkeit der CheckBox

• Font – Standard-Systemfont
  Schriftart des Textes

• ForeColor – ControlText
  Textfarbe

• BackColor – Transparent
  Hintergrundfarbe

• Dock – None
  Docking innerhalb des Containers

• Anchor – (Top, Left)
  Verhalten bei Größenänderung des Containers

• Location – (0,0)
  Position innerhalb des Containers

• Size – (104,24 ungefähr)
  Größe der CheckBox

• TabIndex – 0
  Reihenfolge beim Durchtabben

• TabStop – $true
  Ob die CheckBox per TAB erreichbar ist

Items

• Items – (leer)
  Sammlung aller Listeneinträge
• MultiColumn – $false
  Mehrspaltige Darstellung aktivieren
• SelectedIndex – -1
  Index des aktuell ausgewählten Elements (-1 = nichts)
• SelectedItem – $null
  Aktuell ausgewähltes Element
• SelectedItems – (leer)
  Collection aller ausgewählten Elemente (bei Multi-Select)
• SelectionMode – One
  Auswahlmodus
  
  • One → Nur ein Eintrag
    
  • MultiSimple → Mehrere ohne STRG
    
  • MultiExtended → Mehrere mit STRG/SHIFT
• Sorted – $false
  Sortiert Einträge automatisch alphabetisch

Größe

• ColumnWidth – 0
  Breite der Spalten bei MultiColumn (0 = automatisch)
  
• Height – (abhängig vom Layout)
  Höhe der ListBox
• HorizontalExtent – 0
  Virtuelle Breite für horizontales Scrollen
• IntegralHeight – $true
  Passt Höhe automatisch an volle Einträge an (kein halbes Item unten)
• ItemHeight – (abhängig von Font)
  Höhe eines einzelnen Eintrags
• Size – (Width=120, Height=96)
  Größe der ListBox
• Width – (abhängig vom Layout)
  Breite der ListBox

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.

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.

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.

OwnerDraw

Typ = [System.Boolean]

Der Wert von OwnerDraw legt fest, ob die Darstellung des ListView vom Entwickler selbst gezeichnet werden soll.

Standardmäßig besitzt diese Eigenschaft den Wert False, wodurch das ListView seine Elemente automatisch anhand der festgelegten Eigenschaften darstellt.

Wird OwnerDraw auf True gesetzt, können die einzelnen Bereiche des ListView über die entsprechenden Zeichen-Events individuell gezeichnet werden. Dazu gehören unter anderem DrawColumnHeader, DrawItem und DrawSubItem.

$listView.OwnerDraw = $true

💡 Hinweis
Bei aktiviertem OwnerDraw müssen die entsprechenden Draw...-Events behandelt werden, wenn die Darstellung individuell angepasst werden soll. Andernfalls bleibt die Darstellung je nach verwendetem View und behandelten Events unvollständig.

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.

Alignment

Typ = [Systems.Windows.Forms.TabAlignment]

Der Wert von Alignment legt fest, an welcher Seite des TabControl die Tabs dargestellt werden. Standardmäßig ist diese Eigenschaft auf Top gesetzt, wodurch sich die Tabs oberhalb des Inhaltsbereichs befinden. Alternativ können die Tabs auch am unteren (Bottom), linken (Left) oder rechten (Right) Rand angezeigt werden. Die Position der Tabs beeinflusst lediglich deren Darstellung und hat keinen Einfluss auf die enthaltenen TabPage-Instanzen oder deren Funktionalität.

$tabControl.Alignment = "Top"

Anchor

Typ = [Systems.Windows.Forms.AnchorStyles]

Der Wert von Anchor legt fest, an welchen Rändern seines Parent-Containers ein Control verankert ist. Standardmäßig ist diese Eigenschaft auf Top, Left gesetzt, wodurch das Control seinen Abstand zum oberen und linken Rand beibehält. Wird die Größe des Parent-Containers verändert, passt das Control seine Position oder Größe entsprechend den festgelegten Verankerungen an.

Mehrere Verankerungen können kombiniert werden. Ist ein Control beispielsweise an Left und Right verankert, wird seine Breite automatisch angepasst, um den Abstand zu beiden Rändern beizubehalten. Durch die Kombination verschiedener Werte lässt sich das Verhalten eines Controls bei Größenänderungen flexibel steuern.

Appearance

Typ = [System.Windows.Forms.TabAppearance]

Der Wert von Appearance legt fest, wie die Tabs eines TabControl dargestellt werden. Standardmäßig ist diese Eigenschaft auf Normal gesetzt, wodurch die Tabs im klassischen Registerkarten-Stil angezeigt werden. Alternativ können die Tabs als Schaltflächen (Buttons) oder als flache Schaltflächen (FlatButtons) dargestellt werden.

• Normal → klassische Registerkarten
• Buttons → Tabs werden wie normale Schaltflächen dargestellt
• FlatButtons → Tabs werden wie flache Schaltflächen dargestellt

Die Eigenschaft beeinflusst ausschließlich das Erscheinungsbild der Tabs und hat keinen Einfluss auf die Funktionalität des TabControl oder der enthaltenen TabPage-Instanzen. Unabhängig von der gewählten Darstellung können Tabs weiterhin ausgewählt und gewechselt werden.

Dock

Typ = [Systems.Windows.Forms.DockStyle]

Der Wert von Dock legt fest, an welcher Seite seines Parent-Containers ein Control angedockt wird. Standardmäßig ist diese Eigenschaft auf None gesetzt, wodurch die Position und Größe des Controls ausschließlich durch dessen Location- und Size-Eigenschaften bestimmt werden. Alternativ kann das Control an den oberen (Top), unteren (Bottom), linken (Left) oder rechten (Right) Rand angedockt oder mit Fill auf die gesamte verfügbare Fläche des Parent-Containers ausgedehnt werden.

Im Gegensatz zu Anchor bestimmt Dock nicht die Abstände zu den Rändern, sondern übernimmt die automatische Positionierung und Größenanpassung des Controls. Wird beispielsweise Fill verwendet, füllt das Control den gesamten verfügbaren Bereich seines Parent-Containers aus.

DrawMode

Typ = [Systems.Windows.Forms.TabDrawMode]

Der Wert von DrawMode legt fest, wie die Tabs des TabControl gezeichnet werden. Standardmäßig ist diese Eigenschaft auf Normal gesetzt, wodurch das Betriebssystem die Darstellung der Tabs vollständig übernimmt. Wird DrawMode auf OwnerDrawFixed gesetzt, ist der Entwickler für das Zeichnen der Tabs verantwortlich und kann deren Aussehen individuell gestalten.

Die Einstellung OwnerDrawFixed wird häufig verwendet, um eigene Farben, Schriftarten oder Symbole für Tabs darzustellen. Da die Tabs dabei selbst gezeichnet werden müssen, wird zusätzlich das DrawItem-Event benötigt, in dem die eigentliche Darstellung implementiert wird.

HotTrack

Typ = [System.Boolean]

Der Wert von HotTrack legt fest, ob Tabs auf Mausbewegungen reagieren sollen. Standardmäßig ist diese Eigenschaft auf False gesetzt, wodurch Tabs ihr Aussehen beim Überfahren mit dem Mauszeiger nicht verändern. Wird HotTrack auf True gesetzt, hebt das TabControl den Tab unter dem Mauszeiger visuell hervor, um die Interaktion für den Benutzer deutlicher zu machen.

ImageList

Typ = [System.Windows.Forms.ImageList]

Der Wert von ImageList legt die Bildersammlung fest, aus der das TabControl die Symbole für seine TabPage-Register bezieht.

Die Eigenschaft selbst bestimmt noch nicht, welches Bild angezeigt wird. Stattdessen wird für jede TabPage über deren Eigenschaften ImageIndex oder ImageKey festgelegt, welches Bild aus der ImageList verwendet werden soll.

$imageList = [System.Windows.Forms.ImageList]::new()

$imageList.Images.Add("Home", [System.Drawing.Image]::FromFile("Home.png"))
$imageList.Images.Add("Settings", [System.Drawing.Image]::FromFile("Settings.png"))

$tabControl.ImageList = $imageList

$tabPage1.ImageKey = "Home"
$tabPage2.ImageKey = "Settings"

💡 Hinweis
Die Eigenschaft ImageList wird auf dem TabControl festgelegt. Welche Grafik angezeigt wird, bestimmen anschließend die Eigenschaften ImageIndex oder ImageKey der jeweiligen TabPage.

ItemSize

Typ = [System.Drawing.Size]

Der Wert von ItemSize legt die Größe der einzelnen Tabs fest. Standardmäßig besitzt diese Eigenschaft den Wert (Width=0, Height=0), wodurch die Größe der Tabs automatisch durch das TabControl bestimmt wird. Die Eigenschaft wird erst relevant, wenn SizeMode auf Fixed gesetzt ist. In diesem Fall verwendet das TabControl die in ItemSize festgelegte Breite und Höhe für alle Tabs.

Multiline

Typ = [System.Boolean]

Der Wert von Multiline legt fest, ob die Tabs auf mehrere Reihen verteilt werden dürfen. Standardmäßig ist diese Eigenschaft auf False gesetzt, wodurch alle Tabs in einer einzelnen Reihe dargestellt werden. Wird Multiline auf True gesetzt, erstellt das TabControl bei Platzmangel automatisch zusätzliche Reihen, sodass alle Tabs sichtbar bleiben können.

Padding

Typ = [System.Windows.Forms.Padding]

Der Wert von Padding legt den Innenabstand innerhalb der Tab-Header fest. Standardmäßig ist diese Eigenschaft auf (6, 3) gesetzt. Dadurch wird zwischen dem Rand eines Tabs und dessen Inhalt, beispielsweise dem Text oder einem Icon, ein zusätzlicher Abstand eingefügt.

Die Eigenschaft beeinflusst nicht den Inhalt der enthaltenen TabPage-Instanzen, sondern ausschließlich die Darstellung der Tabs selbst. Durch größere Werte kann mehr Platz zwischen dem Rand eines Tabs und dessen Inhalt geschaffen werden, während kleinere Werte zu einer kompakteren Darstellung führen.

RowCount

Typ = [System.Int32]

Der Wert von RowCount gibt an, aus wie vielen Reihen die Tabs aktuell bestehen. Standardmäßig beträgt der Wert 0, solange sich keine TabPage im TabControl befindet. Die Eigenschaft wird vom TabControl automatisch ermittelt und kann nicht direkt festgelegt werden. Besonders relevant ist RowCount, wenn Multiline auf True gesetzt ist, da die Tabs dann auf mehrere Reihen verteilt werden können.

SelectedImageIndex

Typ = [System.Int32]

Der Wert von SelectedImageIndex legt den Index des Bildes fest, das für den aktuell ausgewählten Tab verwendet werden soll. Standardmäßig ist diese Eigenschaft auf -1 gesetzt, wodurch kein spezielles Bild für den aktiven Tab definiert ist. Die Bilder werden dabei aus der dem TabControl zugewiesenen ImageList bezogen.

Ist ein gültiger Bildindex angegeben, kann für den ausgewählten Tab ein anderes Symbol als für die übrigen Tabs dargestellt werden. Die Eigenschaft wird hauptsächlich in Verbindung mit einer ImageList verwendet und hat ohne zugewiesene Bilder keine sichtbare Auswirkung.

SelectedIndex

Typ = [System.Int32]

Der Wert von SelectedIndex entspricht dem Index des aktuell aktiven TabPage. Die TabPages-Collection ist 0-basiert, weshalb das erste TabPage den Index 0 besitzt. Befindet sich mindestens ein TabPage im TabControl, ist standardmäßig das erste TabPage aktiv. Ist die TabPages-Collection leer, beträgt der Wert von SelectedIndex -1.

SelectedTab

Typ = [System.Windows.Forms.TabPage]

Der Wert von SelectedTab enthält eine Referenz auf die aktuell aktive TabPage des TabControl. Standardmäßig ist diese Eigenschaft auf $null gesetzt, solange sich keine TabPage in der TabPages-Collection befindet. Sobald mindestens ein TabPage vorhanden ist, verweist SelectedTab auf das aktuell ausgewählte TabPage. Über diese Eigenschaft kann sowohl das aktive TabPage ausgelesen als auch ein anderes TabPage direkt ausgewählt werden.

ShowToolTips

Typ = [System.Boolean]

Der Wert von ShowToolTips legt fest, ob für die Tabs eines TabControl Tooltips angezeigt werden dürfen. Standardmäßig ist diese Eigenschaft auf $false gesetzt, wodurch keine Tooltips dargestellt werden. Wird ShowToolTips auf $true gesetzt, können einzelnen TabPage-Instanzen Tooltip-Texte zugewiesen werden, die beim Überfahren des jeweiligen Tabs mit dem Mauszeiger angezeigt werden.

SizeMode

Typ = [Systems.Windows.Forms.TabSizeMode]

Der Wert von SizeMode legt fest, wie die Größe der einzelnen Tabs bestimmt wird. Standardmäßig ist diese Eigenschaft auf Normal gesetzt, wodurch die Breite jedes Tabs automatisch anhand seines Inhalts berechnet wird. Wird SizeMode auf Fixed gesetzt, erhalten alle Tabs dieselbe Größe, die über die Eigenschaft ItemSize festgelegt werden kann.

TabPages

Typ = [Systems.Windows.Forms.TabControl.TabPageCollection]

Der Wert von TabPages enthält die Sammlung aller TabPage-Instanzen, die dem TabControl hinzugefügt wurden. Standardmäßig ist diese Sammlung leer. Über TabPages können TabPage-Instanzen hinzugefügt, entfernt oder anhand ihres Indexes bzw. ihrer Referenz abgerufen werden. Die Reihenfolge der Elemente innerhalb der Sammlung entspricht dabei der Reihenfolge der Tabs im TabControl.

GetTabRect()

$tabControl.GetTabRect( $Index )

Parameter

• $Index [System.Int32]
  Index der TabPage in TabControl

Beschreibung

Die Methode GetTabRect() gibt die Position und Größe eines Tabs innerhalb des TabControl zurück.
Über den angegebenen Index wird festgelegt, für welchen Tab die Informationen ermittelt werden sollen. Der Rückgabewert ist ein Rectangle, das die Position sowie die Breite und Höhe des entsprechenden Tab-Headers enthält. Die zurückgegebenen Koordinaten beziehen sich auf das TabControl selbst.

Die Methode wird häufig verwendet, um Mausklicks auf einzelne Tabs zu erkennen oder um eigene Zeichnungslogik mit OwnerDrawFixed umzusetzen.

Rückgabe

Gibt die Position und Größe des Tab-Headers der TabPage zurück.

Rückgabetyp [System.Drawing.Rectangle]

Add

$_.TabPages.Add( $tabPage )
# → vorhandenes TabPage hinzufügen

Die Methode Add() fügt eine TabPage zur TabPages-Collection hinzu. Das TabPage wird dabei am Ende der Sammlung eingefügt und erscheint als neuer Tab im TabControl.

Nach dem Hinzufügen kann das TabPage über die TabPages-Collection, SelectedIndex oder SelectedTab verwendet werden.

$_.TabPages.Add( "Text" )
# → Neues TabPage mit Text erstellen

Der übergebene Text wird dabei als Beschriftung des Tabs verwendet. 

$_.TabPages.Add( "Name", "Text" )
# → Neues TabPage mit Name und Text erstellen

Hierbei wird sowohl der interne Name als auch die sichtbare Beschriftung (Text) festgelegt.

Diese Varianten eignen sich für einfache Tabs, bei denen keine weiteren Eigenschaften unmittelbar gesetzt werden müssen.

Rückgabetyp [void]

AddRange()

$_.TabPages.AddRange( $tabPages )

Die Methode AddRange() fügt mehrere TabPage-Instanzen gleichzeitig zur TabPages-Collection hinzu.

Die Reihenfolge der Elemente im Array entspricht anschließend der Reihenfolge der Tabs im TabControl. Die Tabs werden dabei am Ende der vorhandenen Sammlung eingefügt.

Clear()

$_.TabPages.Clear()

Die Methode Clear() entfernt alle TabPage-Instanzen aus der TabPages-Collection.

Nach dem Aufruf enthält das TabControl keine Tabs mehr. Existiert kein Tab mehr, besitzen Eigenschaften wie SelectedIndex den Wert -1 und SelectedTab den Wert $null.

Insert()

$_.TabPages.Insert( Index, $tabPage )

Die Methode Insert() fügt eine TabPage an einer bestimmten Position innerhalb der TabPages-Collection ein.

Bereits vorhandene Einträge werden ab dieser Position um eine Stelle nach hinten verschoben. Dadurch kann die Reihenfolge der Tabs gezielt beeinflusst werden.

Remove()

$_.TabPages.Remove( $tabPage )

Die Methode Remove() entfernt eine bestimmte TabPage aus der TabPages-Collection.

Das TabPage selbst wird dabei nicht gelöscht, sondern lediglich aus dem TabControl entfernt. Es kann später erneut einer TabPages-Collection hinzugefügt werden.

Rückgabetyp [void]

RemoveAt()

$_.TabPages.RemoveAt( Index )

Die Methode RemoveAt() entfernt die TabPage an der angegebenen Position aus der TabPages-Collection.

Die verbleibenden Einträge rücken anschließend entsprechend nach vorne auf. Dadurch können sich die Indizes nachfolgender TabPages ändern.

TabPage

• Selecting – Vor dem Wechsel zum TabPage
• Selected – Nach dem Wechsel zum TabPage
• Deselecting – Vor dem Verlassen vom TabPage
• Deselected – Nach dem Verlassen vom TabPage
• SelectedIndexChanged – Ausgewählter TabPage hat sich geändert

Cursor

• Click – Mausklick auf das TabControl
• DoubleClick – Doppelklick auf das TabControl
• MouseDown – Maustaste wurde auf dem TabControl gedrückt
• MouseMove – Maus wurde über dem TabControl bewegt
• MouseUp – Gedrückte Maustaste wurde auf dem TabControl losgelassen
• MouseEnter – Mauszeiger betritt den Bereich des TabControl
• MouseLeave – Mauszeiger verlässt den Bereich des TabControl
• DragDrop – Element wurde per Drag&Drop auf dem TabControl abgelegt

Tastatur

• KeyDown – Taste wurde gedrückt während das TabControl den Fokus hat

Control

• ControlAdded – Dem TabControl wurde ein TabPage hinzugefügt
• ControlRemoved – Vom TabControl wurde ein TabPage entfernt

Design

• Resize – Größe des TabControl hat sich geändert
• Paint – TabControl wird neu gezeichnet

Selecting

Das Selecting-Event wird unmittelbar vor dem Wechsel auf einen anderen Tab ausgelöst.

Zu diesem Zeitpunkt ist der neue Tab noch nicht ausgewählt. Über die Ereignisargumente kann ermittelt werden, welcher Tab ausgewählt werden soll. Da die Ereignisargumente die Eigenschaft Cancel besitzen, kann der Tabwechsel bei Bedarf verhindert werden.

Dieses Event eignet sich beispielsweise, um Eingaben zu validieren oder den Benutzer vor dem Verlassen eines Tabs zu warnen.

Beispiel

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

    if ($e.TabPage.Name -eq "tabSettings") {
        Write-Host "Einstellungen werden geöffnet."
    }
})

Tabwechsel verhindern

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

    if (-not $datenGespeichert) {
        $e.Cancel = $true
        [System.Windows.Forms.MessageBox]::Show(
            "Bitte speichern Sie zuerst Ihre Änderungen."
        )
    }
})

💡 Hinweis
Das Selecting-Event wird vor dem eigentlichen Tabwechsel ausgelöst. Soll lediglich auf einen bereits abgeschlossenen Tabwechsel reagiert werden, eignet sich stattdessen Selected oder SelectedIndexChanged.

Selected

Das Selected-Event wird unmittelbar nach dem Wechsel auf einen anderen Tab ausgelöst.

Zu diesem Zeitpunkt ist der neue Tab bereits ausgewählt und aktiv. Über die Ereignisargumente kann ermittelt werden, welcher TabPage ausgewählt wurde.

Dieses Event eignet sich beispielsweise, um Daten zu laden, die Oberfläche zu aktualisieren oder Aktionen auszuführen, sobald ein bestimmter Tab geöffnet wurde.

Beispiel

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

    if ($e.TabPage.Name -eq "tabSettings") {
        Write-Host "Einstellungen wurden geöffnet."
    }
})

Daten beim Öffnen eines Tabs laden

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

    if ($e.TabPage.Name -eq "tabLog") {
        Update-LogView
    }
})

💡 Hinweis
Das Selected-Event wird nach dem erfolgreichen Tabwechsel ausgelöst. Soll der Wechsel vorab geprüft oder verhindert werden, eignet sich stattdessen das Selecting-Event.

$sender

• SelectedTab → aktuell aktiver Tab (TabPage)
• SelectedIndex → Index davon
• TabPages → alle Tabs (Collection)
• TabCount → Anzahl Tabs
• Name → Name vom Control
• Enabled → ob aktiv
• Visible → sichtbar oder nicht
  

$e

Ein Standard-EventArgs-Objekt, ohne nützliche Zusatzinfos

$sender 

Das TabControl selbst (=$this)

$e

• TabPage → das TabPage, von dem gewechselt werden soll
  
• TabPageIndex → Index vom TabPage, von dem gewechselt werden soll
• Cancel → Mit $true wird der Wechsel verhindert
  

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

• $e.Button – gedrückte Maustaste → [MouseButtons]::Left
• $e.Location – Position des Mausklicks

Typ = [System.Boolean]

Die Eigenschaft AutoScroll legt fest, ob das Panel automatisch Scrollleisten anzeigt, wenn sein Inhalt größer als der sichtbare Bereich ist.

Standardmäßig ist AutoScroll auf False gesetzt.

Wird die Eigenschaft auf True gesetzt, erscheinen horizontale und/oder vertikale Scrollleisten automatisch, sobald der Inhalt nicht mehr vollständig in das Panel passt.

$panel.AutoScroll = $true

Typ = [System.Boolean]

Die Eigenschaft AutoSize legt fest, ob das Panel seine Größe automatisch an seinen Inhalt anpasst.

Standardmäßig besitzt diese Eigenschaft den Wert False.

Ist AutoSize aktiviert, wird die benötigte Größe des Panels anhand seiner enthaltenen Controls und deren Layoutinformationen bestimmt.

$panel.AutoSize = $true

Typ = [System.Windows.Forms.AutoSizeMode]

Die Eigenschaft AutoSizeMode bestimmt, wie sich das Panel bei aktiviertem AutoSize an seinen Inhalt anpasst.

Es stehen zwei Werte zur Verfügung:

• GrowAndShrink → Das Panel kann seine Größe sowohl vergrößern als auch verkleinern.
• GrowOnly → Das Panel kann nur größer werden, aber nicht automatisch kleiner.

Standardmäßig ist GrowOnly eingestellt.

$panel.AutoSize = $true
$panel.AutoSizeMode = "GrowAndShrink"

Typ = [System.Drawing.Color]

Die Eigenschaft BackColor legt die Hintergrundfarbe des Panels fest.

$panel.BackColor = "LightBlue"

Die Hintergrundfarbe betrifft ausschließlich die vom Panel selbst dargestellte Fläche. Die enthaltenen Controls behalten grundsätzlich ihre eigene Darstellung.

Typ = [System.Windows.Forms.BorderStyle]

Die Eigenschaft BorderStyle bestimmt, ob das Panel einen Rahmen darstellt.

Mögliche Werte:

• None → kein Rahmen
• FixedSingle → einfacher Rahmen
• Fixed3D → dreidimensionaler Rahmen

Standardmäßig besitzt BorderStyle den Wert None.

$panel.BorderStyle = "FixedSingle"

Der Rahmen dient hauptsächlich der visuellen Abgrenzung des Panels und verändert nicht die grundlegende Funktion des Containers.

Typ = [System.Windows.Forms.Control+ControlCollection]

Die Eigenschaft Controls enthält alle Controls, die direkt innerhalb des Panels liegen.

Über diese Collection können Controls hinzugefügt, entfernt oder abgerufen werden.

$panel.Controls.Add($button)

$panel.Controls.Remove($button)

$panel.Controls.Clear()

Ein Control kann über seinen Index abgerufen werden:

$panel.Controls[0]

Die Collection enthält dabei nur die direkt im Panel enthaltenen Controls. Controls, die wiederum innerhalb eines anderen Panels liegen, gehören nicht direkt zu dieser Collection.

Typ = [System.Windows.Forms.DockStyle]

Die Eigenschaft Dock legt fest, wie das Panel innerhalb seines Parent-Containers angedockt wird.

Standardmäßig besitzt Dock den Wert None.

Alternativ kann das Panel an einer Seite angedockt werden:

• Top
• Bottom
• Left
• Right
• Fill

Mit Fill nimmt das Panel den gesamten verfügbaren Bereich des Parent-Containers ein.

$panel.Dock = "Fill"

Dies ist besonders praktisch, wenn ein Panel als Arbeitsbereich innerhalb eines Form, TabPage oder eines anderen Containers verwendet wird.

Typ = [System.Windows.Forms.AnchorStyles]

Die Eigenschaft Anchor legt fest, an welchen Rändern des Parent-Containers das Panel verankert bleibt.

Standardmäßig ist das Panel an Top und Left verankert.

$panel.Anchor = "Top, Left, Right"

Wird ein Panel beispielsweise an Left und Right verankert, passt sich seine Breite an die Größe des Parent-Containers an.

Im Gegensatz zu Dock behält Anchor die Abstände zu den angegebenen Rändern bei.

Typ = [System.Windows.Forms.Padding]

Die Eigenschaft Padding legt den Innenabstand zwischen dem Rand des Panels und seinen enthaltenen Controls fest.

$panel.Padding = 10

Dadurch beginnen enthaltene Controls nicht direkt am Rand des Panels.

Der Unterschied zu Margin:

Margin  → Abstand außerhalb des Panels
Padding → Abstand innerhalb des Panels

Typ = [System.Windows.Forms.Padding]

Die Eigenschaft Margin legt den äußeren Abstand des Panels zu anderen Controls fest.

$panel.Margin = 10

Die Eigenschaft wird insbesondere von Layout-Containern wie FlowLayoutPanel und TableLayoutPanel berücksichtigt.

Typ = [System.Drawing.Point]

Die Eigenschaft Location bestimmt die Position des Panels innerhalb seines Parent-Containers.

Die Position wird über die X- und Y-Koordinate angegeben.

$panel.Location = "20, 40"

Da ein normales Panel kein eigenes Layoutsystem besitzt, ist Location insbesondere für die Positionierung der enthaltenen Controls relevant.

$button.Location = "10, 10"
$label.Location  = "10, 50"

Typ = [System.Drawing.Size]

Die Eigenschaft Size bestimmt die Breite und Höhe des Panels.

$panel.Size = "300, 200"

Die Größe kann auch durch Dock, Anchor oder AutoSize beeinflusst werden.

Typ = [System.Boolean]

Die Eigenschaft Visible legt fest, ob das Panel sichtbar dargestellt wird.

$panel.Visible = $false

Wird das Panel ausgeblendet, werden auch seine enthaltenen Controls nicht sichtbar dargestellt.

Typ = [System.Boolean]

Die Eigenschaft Enabled legt fest, ob das Panel aktiviert ist.

$panel.Enabled = $false

Wird ein Panel deaktiviert, können auch seine enthaltenen Controls nicht mehr über die Benutzeroberfläche bedient werden.

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

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

$groupBox.Controls.Add($button)

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 [System.Windows.Forms.Padding]

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

$groupBox.Padding = 10

Text [System.String]

Der Wert von Text bestimmt die Beschriftung der GroupBox.

Standardmäßig ist der Wert leer.

$groupBox.Text = "Office Installation"

AutoScroll

Typ = [System.Boolean]

Der Wert von AutoScroll legt fest, ob das FlowLayoutPanel automatisch Scrollleisten anzeigt, wenn der enthaltene Inhalt größer als der sichtbare Bereich ist.

Standardmäßig besitzt diese Eigenschaft den Wert False.

Ist AutoScroll auf True gesetzt, werden horizontale und/oder vertikale Scrollleisten angezeigt, sobald die enthaltenen Controls nicht mehr vollständig in den verfügbaren Bereich passen.

$flow.AutoScroll = $true

💡 Hinweis AutoScroll ist besonders nützlich, wenn die Anzahl oder Größe der enthaltenen Controls zur Laufzeit variieren kann.

AutoSize

Typ = [System.Boolean]

Der Wert von AutoSize legt fest, ob sich die Größe des FlowLayoutPanel automatisch an seinen Inhalt anpasst.

Standardmäßig besitzt diese Eigenschaft den Wert False.

Ist AutoSize aktiviert, kann das Panel seine Größe anhand der enthaltenen Controls und deren Layout bestimmen.

$flow.AutoSize = $true

💡 Hinweis Das tatsächliche Verhalten von AutoSize hängt unter anderem von FlowDirection, WrapContents, Dock und den Größen der enthaltenen Controls ab.

BackColor

Typ = [System.Drawing.Color]

Der Wert von BackColor legt die Hintergrundfarbe des FlowLayoutPanel fest.

$flow.BackColor = "WhiteSmoke"

BorderStyle

Typ = [System.Windows.Forms.BorderStyle]

Der Wert von BorderStyle bestimmt, ob und wie das FlowLayoutPanel einen sichtbaren Rahmen besitzt.

Folgende Werte stehen zur Verfügung:

• None → kein Rahmen
• FixedSingle → einfacher Rahmen
• Fixed3D → dreidimensionaler Rahmen

$flow.BorderStyle = "FixedSingle"

Controls

Typ = [System.Windows.Forms.Control.ControlCollection]

Die Eigenschaft Controls enthält alle Controls, die sich innerhalb des FlowLayoutPanel befinden.

Über diese Collection können Controls hinzugefügt, entfernt oder ausgelesen werden.

$flow.Controls.Add($button)

Mehrere Controls können beispielsweise über eine Schleife hinzugefügt werden:

foreach ($button in $buttons) {
    $flow.Controls.Add($button)
}

Die Reihenfolge der Controls innerhalb der Collection entspricht dabei grundsätzlich auch der Reihenfolge, in der sie vom Layoutsystem angeordnet werden.

Dock

Typ = [System.Windows.Forms.DockStyle]

Der Wert von Dock legt fest, an welcher Seite seines Parent-Containers das FlowLayoutPanel angedockt wird.

$flow.Dock = "Fill"

Mit Fill nimmt das Panel den gesamten verfügbaren Bereich seines Parent-Containers ein.

Weitere mögliche Werte sind:

• None
• Top
• Bottom
• Left
• Right
• Fill

💡 Hinweis Wird Dock = "Fill" verwendet, passt sich das Panel automatisch an die Größe des Parent-Containers an. Dadurch kann insbesondere WrapContents seine Wirkung beim Vergrößern oder Verkleinern des Fensters zeigen.

FlowDirection

Typ = [System.Windows.Forms.FlowDirection]

Der Wert von FlowDirection bestimmt die Richtung, in der die enthaltenen Controls angeordnet werden.

Standardmäßig besitzt diese Eigenschaft den Wert LeftToRight.

Folgende Werte stehen zur Verfügung:

$flow.FlowDirection = "LeftToRight"

Beispiel für eine vertikale Anordnung:

$flow.FlowDirection = "TopDown"

💡 Hinweis Zusammen mit WrapContents bestimmt FlowDirection, in welche Richtung das Layout zunächst fließt und wann ein Umbruch erfolgt.

Location

Typ = [System.Drawing.Point]

Der Wert von Location legt die Position des FlowLayoutPanel innerhalb seines Parent-Containers fest.

Die Position wird über die X- und Y-Koordinate angegeben.

$flow.Location = "20, 40"

💡 Hinweis Wird zusätzlich Dock verwendet, wird die Position durch das Layoutsystem bestimmt.

Margin

Typ = [System.Windows.Forms.Padding]

Der Wert von Margin legt den äußeren Abstand des FlowLayoutPanel zu seinem Parent-Container fest.

$flow.Margin = [System.Windows.Forms.Padding]::new(10)

Bei den enthaltenen Controls besitzt Margin eine zusätzliche Bedeutung: Das FlowLayoutPanel berücksichtigt den Außenabstand der einzelnen Controls bei der automatischen Anordnung.

$button.Margin = [System.Windows.Forms.Padding]::new(5)

Dadurch entsteht beispielsweise ein Abstand von 5 Pixeln zwischen den einzelnen Controls.

MaximumSize

Typ = [System.Drawing.Size]

Der Wert von MaximumSize legt die maximal zulässige Größe des FlowLayoutPanel fest.

Standardmäßig besitzt diese Eigenschaft den Wert (0,0), wodurch keine Größenbegrenzung besteht.

$flow.MaximumSize = "600, 400"

MinimumSize

Typ = [System.Drawing.Size]

Der Wert von MinimumSize legt die minimal zulässige Größe des FlowLayoutPanel fest.

$flow.MinimumSize = "200, 100"

Wird versucht, das Panel kleiner als die angegebene Mindestgröße zu machen, bleibt diese Mindestgröße erhalten.

Name

Typ = [System.String]

Der Wert von Name legt den internen Namen des FlowLayoutPanel fest.

Der Name dient ausschließlich zur Identifikation innerhalb des Programms.

$flow.Name = "flowButtons"

Padding

Typ = [System.Windows.Forms.Padding]

Der Wert von Padding legt den Innenabstand zwischen dem Rand des FlowLayoutPanel und seinen enthaltenen Controls fest.

$flow.Padding = [System.Windows.Forms.Padding]::new(10)

Dadurch werden die enthaltenen Controls mit einem Abstand von 10 Pixeln zum Rand des Panels angeordnet.

💡 Hinweis Padding betrifft den Innenbereich des Panels, während Margin den Außenabstand des Panels beziehungsweise der enthaltenen Controls beschreibt.

Size

Typ = [System.Drawing.Size]

Der Wert von Size legt die Breite und Höhe des FlowLayoutPanel fest.

$flow.Size = "500, 300"

Die tatsächliche Größe kann durch AutoSize, Dock oder andere Layoutmechanismen beeinflusst werden.

WrapContents

Typ = [System.Boolean]

Der Wert von WrapContents legt fest, ob Controls automatisch in eine neue Zeile beziehungsweise Spalte umgebrochen werden, wenn der verfügbare Platz nicht mehr ausreicht.

Standardmäßig besitzt diese Eigenschaft den Wert True.

$flow.WrapContents = $true

Bei einem horizontalen Layout:

[Button 1] [Button 2] [Button 3]
[Button 4] [Button 5] [Button 6]

Wird WrapContents deaktiviert, versucht das FlowLayoutPanel, alle Controls in der ursprünglichen Flussrichtung anzuordnen.

$flow.WrapContents = $false

Bei LeftToRight werden die Controls dadurch beispielsweise weiterhin horizontal angeordnet, auch wenn dadurch der verfügbare Bereich überschritten wird.

💡 Hinweis WrapContents wirkt immer zusammen mit FlowDirection. Die Flussrichtung bestimmt, wohin die Controls zunächst angeordnet werden, während WrapContents bestimmt, ob bei fehlendem Platz ein Umbruch erfolgt.

Visible

Typ = [System.Boolean]

Der Wert von Visible legt fest, ob das FlowLayoutPanel sichtbar dargestellt wird.

$flow.Visible = $false

Enabled

Typ = [System.Boolean]

Der Wert von Enabled legt fest, ob das FlowLayoutPanel aktiviert ist.

Standardmäßig besitzt diese Eigenschaft den Wert True.

$flow.Enabled = $false

Wird das Panel deaktiviert, werden auch die enthaltenen Controls entsprechend deaktiviert dargestellt beziehungsweise reagieren nicht mehr auf Eingaben.

GetFlowBreak()

Die Methode GetFlowBreak() ermittelt, ob für ein bestimmtes Control ein manueller Umbruch festgelegt wurde.

$flow.GetFlowBreak($button)

Der Rückgabewert ist ein Boolean.

True  → Nach dem Control erfolgt ein Umbruch.
False → Es erfolgt kein manueller Umbruch.

Beispiel:

if ($flow.GetFlowBreak($button)) {
    Write-Host "Nach dem Button beginnt eine neue Zeile."
}

SetFlowBreak()

Die Methode SetFlowBreak() legt fest, ob nach einem bestimmten Control ein manueller Umbruch erfolgen soll.

$flow.SetFlowBreak($button, $true)

Der erste Parameter bestimmt das Control, nach dem der Umbruch erfolgen soll.

Der zweite Parameter bestimmt, ob der Umbruch aktiviert oder deaktiviert wird.

$flow.SetFlowBreak($button, $true)

→ Nach dem Button beginnt ein neuer Layoutabschnitt.

$flow.SetFlowBreak($button, $false)

→ Der manuelle Umbruch wird wieder entfernt.

Beispiel

$flow = [System.Windows.Forms.FlowLayoutPanel]::new()

$button1 = [System.Windows.Forms.Button]::new()
$button1.Text = "Button 1"

$button2 = [System.Windows.Forms.Button]::new()
$button2.Text = "Button 2"

$button3 = [System.Windows.Forms.Button]::new()
$button3.Text = "Button 3"

$flow.Controls.Add($button1)
$flow.Controls.Add($button2)
$flow.Controls.Add($button3)

$flow.SetFlowBreak($button2, $true)

Das Layout kann dadurch beispielsweise so aussehen:

[Button 1] [Button 2]
[Button 3]

💡 Hinweis SetFlowBreak() ist besonders praktisch, wenn einzelne Controls unabhängig von der verfügbaren Breite einen neuen Layoutabschnitt beginnen sollen.

ControlAdded

Das Event ControlAdded wird ausgelöst, sobald ein Control zur Controls-Collection des FlowLayoutPanel hinzugefügt wurde.

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

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

Das Event kann beispielsweise verwendet werden, um neu hinzugefügte Controls automatisch zu konfigurieren.

ControlRemoved

Das Event ControlRemoved wird ausgelöst, sobald ein Control aus der Controls-Collection entfernt wurde.

$flow.Add_ControlRemoved({
    param($sender, $e)

    Write-Host "Control entfernt: $($e.Control.Name)"
})

Layout

Das Event Layout wird ausgelöst, wenn das Layout des FlowLayoutPanel neu berechnet wird.

$flow.Add_Layout({
    param($sender, $e)

    Write-Host "Layout wurde aktualisiert."
})

Das Event kann beispielsweise verwendet werden, wenn auf Änderungen der Größe oder Anordnung der enthaltenen Controls reagiert werden soll.

⚠️ Hinweis Das Layout-Event kann relativ häufig ausgelöst werden. Aufwendige Operationen sollten daher nicht unkontrolliert innerhalb dieses Events ausgeführt werden.

AutoScroll

Die Eigenschaft AutoScroll legt fest, ob das TableLayoutPanel automatisch Scrollleisten anzeigt, wenn der Inhalt größer ist als der sichtbare Bereich.

Ist AutoScroll auf True gesetzt, erscheinen horizontale und/oder vertikale Scrollleisten nur dann, wenn sie tatsächlich benötigt werden. Dadurch bleiben auch Controls erreichbar, die sich außerhalb des aktuell sichtbaren Bereichs befinden.

Beispiel:

$table.AutoScroll = $true

Sind mehr Controls vorhanden, als im verfügbaren Bereich angezeigt werden können, fügt das TableLayoutPanel automatisch die erforderlichen Scrollleisten hinzu.

Hinweis:

• AutoScroll ist standardmäßig deaktiviert (False).
• Scrollleisten werden nur angezeigt, wenn der Inhalt die sichtbare Größe des TableLayoutPanel überschreitet.
• Besonders nützlich bei dynamischen Benutzeroberflächen, deren Anzahl an Controls zur Laufzeit variieren kann.

AutoSize

Passt die Größe automatisch an den Inhalt an.

Beispiel:

$table.AutoSize = $true

CellBorderStyle

Legt fest, ob zwischen den Zellen Rahmen gezeichnet werden.

Mögliche Werte

• None

• Single

• Inset

• Outset

• InsetDouble

• OutsetDouble

Beispiel:

$table.CellBorderStyle = "Single"

ColumnCount

Legt fest, aus wie vielen Spalten das Layout besteht.

Beispiel:

$table.ColumnCount = 3

ColumnStyles

Bestimmt die Breite jeder einzelnen Spalte.

Es gibt drei verschiedene Größenarten:

Beispiel:

$table.ColumnStyles.Add(
    [System.Windows.Forms.ColumnStyle]::new("Percent",50)
)

$table.ColumnStyles.Add(
    [System.Windows.Forms.ColumnStyle]::new("Percent",50)
)

Dock

Legt fest, wie das TableLayoutPanel innerhalb seines Parent-Containers angedockt wird.

Beispiel:

$table.Dock = "Fill"

Dies ist die häufigste Einstellung.

GrowStyle

Legt fest, wie das Panel reagiert, wenn mehr Controls hinzugefügt werden als Zellen vorhanden sind.

Mögliche Werte

• AddRows

• AddColumns

• FixedSize

Beispiel:

$table.GrowStyle = "AddRows"

Bei FixedSize wird eine Ausnahme ausgelöst, wenn kein Platz mehr vorhanden ist.

RowCount

Legt die Anzahl der Zeilen fest, die das TableLayoutPanel enthält.

Zusammen mit ColumnCount bestimmt diese Eigenschaft die Größe des Tabellenrasters. Jede Zeile kann anschließend über die Eigenschaft RowStyles individuell konfiguriert werden.

Beispiel:

$table.RowCount = 3

Das TableLayoutPanel besitzt nun drei Zeilen.

Hinweis:

• RowCount legt lediglich die Anzahl der Zeilen fest. Die Höhe der einzelnen Zeilen wird über RowStyles bestimmt.

• Zusammen mit ColumnCount ergibt sich die Gesamtzahl der verfügbaren Zellen.

• Wird GrowStyle auf AddRows gesetzt, kann das TableLayoutPanel bei Bedarf automatisch weitere Zeilen hinzufügen.

RowStyles

Bestimmt die Höhe jeder Zeile.

Auch hier stehen

• Absolute

• Percent

• AutoSize

zur Verfügung.

Beispiel:

$table.RowStyles.Add(
    [System.Windows.Forms.RowStyle]::new("AutoSize")
)

GetControlFromPosition()

$table.GetControlFromPosition(1,0)

Beschreibung:

Liefert das Control zurück, das sich in der angegebenen Spalte und Zeile befindet.

Rückgabe

Rückgabetyp System.Windows.Forms.Control

GetPositionFromControl()

$table.GetPositionFromControl($button)

Beschreibung:

Ermittelt die aktuelle Position eines Controls innerhalb des Rasters.

Rückgabe:

Rückgabetyp System.Windows.Forms.TableLayoutPanelCellPosition

SetColumn()

$table.SetColumn($button,2)

Verschiebt ein Control in eine andere Spalte.

SetRow()

$table.SetRow($button,1)

Verschiebt ein Control in eine andere Zeile.

SetColumnSpan()

$table.SetColumnSpan($button,2)

Das Control erstreckt sich über mehrere Spalten.

SetRowSpan()

$table.SetRowSpan($button,3)

Das Control erstreckt sich über mehrere Zeilen.

Insert()

$sizeType = [System.Windows.Forms.SizeType]::Absolute

$rowStyle = [System.Windows.Forms.RowStyle]::new( $sizeType, 50 )

$table.RowStyles.Insert(0, $rowStyle )

Die Methode Insert() fügt an der angegebenen Position einen neuen RowStyle in die RowStyles-Sammlung ein.

Alle vorhandenen Einträge ab diesem Index werden dabei um eine Position nach hinten verschoben. Dadurch kann die Reihenfolge der Zeilenstile geändert oder zwischen bestehenden Zeilen ein neuer Stil eingefügt werden.

Die Methode verändert lediglich die RowStyles-Sammlung. Damit der neue Eintrag einer Zeile zugeordnet werden kann, sollte die Anzahl der Einträge in der Regel mit RowCount übereinstimmen.

Die Methode Insert() erhöht nicht automatisch den Wert der Eigenschaft RowCount. Sie fügt lediglich einen neuen RowStyle in die RowStyles-Sammlung ein. Soll der eingefügte RowStyle einer zusätzlichen Zeile zugeordnet werden, muss RowCount entsprechend erhöht werden.

Rückgabe:

Kein Rückgabewert.

Rückgabetyp System.Void

Beispiel:

$table.RowCount = 3

$firstSizeType = [System.Windows.Forms.SizeType]::Absolute
$firstRowStyle = [System.Windows.Forms.RowStyle]::new( $firstSizeType, 40 )
$table.RowStyles.Add( $firstRowStyle )

$secondSizeType = [System.Windows.Forms.SizeType]::Percent
$secondRowStyle = [System.Windows.Forms.RowStyle]::new( $secondSizeType, 100 )
$table.RowStyles.Add( $secondRowStyle )

# Neuen RowStyle an Position 1 einfügen
$thirdSizeType = [System.Windows.Forms.SizeType]::Absolute
$thirdRowStyle = [System.Windows.Forms.RowStyle]::new( $thirdSizeType, 20 )
$table.RowStyles.Insert( 1, $thirdRowStyle )

Der neue RowStyle wird an Index 1 eingefügt. Der ursprünglich zweite Eintrag verschiebt sich automatisch an die nächste Position.

Layout

Das Event wird ausgelöst, wenn das TableLayoutPanel seine Controls neu anordnet.

Dies geschieht beispielsweise bei

• Größenänderungen

• Änderungen an ColumnStyles

• Änderungen an RowStyles

• Hinzufügen oder Entfernen von Controls

$table.Add_Layout({
    Write-Host "Layout aktualisiert"
})

ControlAdded

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

    Write-Host $e.Control.Name
})

Wird ausgelöst, sobald ein Control hinzugefügt wird.

ControlRemoved

$table.Add_ControlRemoved({
    param($sender,$e)

    Write-Host $e.Control.Name
})

Wird ausgelöst, sobald ein Control entfernt wird.

AcceptButton

Typ = [System.Windows.Forms.IButtonControl]

AcceptButton legt fest, welcher Button ausgelöst wird, wenn der Benutzer innerhalb des Formulars die Enter-Taste betätigt.

$form.AcceptButton = $okButton

Dies ist besonders bei Dialogfenstern praktisch:

$okButton = [System.Windows.Forms.Button]::new()
$okButton.Text = "OK"

$form.AcceptButton = $okButton
$form.Controls.Add($okButton)

Der Benutzer kann dadurch beispielsweise ein Formular mit Enter bestätigen, ohne den Button mit der Maus anzuklicken.

AutoScaleMode

Typ = [System.Windows.Forms.AutoScaleMode]

AutoScaleMode bestimmt, anhand welcher Grundlage das Formular und seine Controls automatisch skaliert werden.

Typische Werte sind:

• None → keine automatische Skalierung
• Font → Skalierung anhand der Schriftgröße
• Dpi → Skalierung anhand der DPI-Einstellung
• Inherit → übernimmt die Einstellung des übergeordneten Controls

$form.AutoScaleMode = "Font"

Gerade bei unterschiedlichen Windows-Skalierungseinstellungen kann diese Eigenschaft wichtig sein, damit die Oberfläche nicht plötzlich aussieht, als hätte Windows sie durch einen Briefkastenschlitz geschoben.

AutoScroll

Typ = [System.Boolean]

AutoScroll aktiviert automatische Scrollleisten, wenn der Inhalt des Formulars größer als dessen sichtbarer Bereich ist.

Standardwert = False

$form.AutoScroll = $true

Die Eigenschaft ist besonders bei Formularen mit dynamisch erzeugten oder umfangreichen Controls hilfreich.

BackColor

Typ = [System.Drawing.Color]

BackColor legt die Hintergrundfarbe des Formulars fest.

$form.BackColor = "White"

BackgroundImage

Typ = [System.Drawing.Image]

BackgroundImage legt ein Bild fest, das als Hintergrund des Formulars dargestellt wird.

$form.BackgroundImage = [System.Drawing.Image]::FromFile(
    "C:\Images\background.png"
)

Die Darstellung des Bildes kann zusätzlich über BackgroundImageLayout beeinflusst werden.

CancelButton

Typ = [System.Windows.Forms.IButtonControl]

CancelButton legt fest, welcher Button ausgelöst wird, wenn der Benutzer die Escape-Taste betätigt.

$form.CancelButton = $cancelButton

Typischerweise wird hier ein Abbrechen-Button hinterlegt.

$cancelButton.DialogResult = "Cancel"

$form.CancelButton = $cancelButton

Bei einem Dialogfenster kann dadurch die Escape-Taste zum Abbrechen verwendet werden.

ClientSize

Typ = [System.Drawing.Size]

ClientSize bestimmt die Größe des nutzbaren Inhaltsbereichs des Formulars.

Im Gegensatz zu Size berücksichtigt ClientSize nicht den Fensterrahmen und die Titelleiste.

$form.ClientSize = "800, 500"

Das ist insbesondere bei Layoutberechnungen interessant, wenn die Größe des eigentlichen Inhaltsbereichs relevant ist.

In deinem Windows-Setup-Helper verwendest du beispielsweise ClientSize, um die Formulargröße abhängig von der ausgewählten TabPage anzupassen.

ControlBox

Typ = [System.Boolean]

ControlBox bestimmt, ob die Steuerelemente der Titelleiste angezeigt werden.

Standardwert = True

$form.ControlBox = $false

Bei deaktivierter ControlBox werden die entsprechenden Fenster-Schaltflächen wie Schließen, Minimieren und Maximieren nicht mehr auf normale Weise dargestellt.

FormBorderStyle

Typ = [System.Windows.Forms.FormBorderStyle]

FormBorderStyle bestimmt die Art des Fensterrahmens und damit unter anderem, ob der Benutzer die Größe des Fensters verändern kann.

Typische Werte:

$form.FormBorderStyle = "FixedDialog"

Für normale Hauptfenster ist Sizable üblich.

Icon

Typ = [System.Drawing.Icon]

Icon legt das Symbol des Formulars fest.

$form.Icon = [System.Drawing.Icon]::ExtractAssociatedIcon(
    "C:\Program Files\App\App.exe"
)

Das Icon kann unter anderem in der Titelleiste und Taskleiste angezeigt werden.

KeyPreview

Typ = [System.Boolean]

KeyPreview bestimmt, ob das Formular Tastatureingaben vor den enthaltenen Controls erhält.

Standardwert = False

$form.KeyPreview = $true

Dadurch können beispielsweise globale Tastenkombinationen auf Formularebene behandelt werden.

$form.Add_KeyDown({
    param($sender, $e)

    if ($e.KeyCode -eq "F5") {
        Write-Host "F5 gedrückt"
    }
})

Ohne KeyPreview kann ein fokussiertes Control die Tastatureingabe zuerst verarbeiten.

Location

Typ = [System.Drawing.Point]

Location legt die Position des Formulars auf dem Bildschirm fest.

$form.Location = "100, 100"

Die beiden Werte entsprechen:

X = 100
Y = 100

Die Startposition kann alternativ über StartPosition automatisch bestimmt werden.

MaximizeBox

Typ = [System.Boolean]

MaximizeBox bestimmt, ob das Fenster über die Titelleiste maximiert werden kann.

Standardwert = True

$form.MaximizeBox = $false

Bei Dialogfenstern wird die Maximierung häufig deaktiviert.

MaximumSize

Typ = [System.Drawing.Size]

MaximumSize legt die maximal zulässige Größe des Formulars fest.

Standardwert = (0,0)

Der Wert (0,0) bedeutet, dass keine maximale Größe festgelegt wurde.

$form.MaximumSize = "1200, 800"

MinimizeBox

Typ = [System.Boolean]

MinimizeBox bestimmt, ob das Fenster über die Titelleiste minimiert werden kann.

Standardwert = True

$form.MinimizeBox = $false

MinimumSize

Typ = [System.Drawing.Size]

MinimumSize legt die minimal zulässige Größe des Formulars fest.

Standardwert = (0,0)

$form.MinimumSize = "600, 400"

Damit kann verhindert werden, dass der Benutzer das Fenster so weit verkleinert, dass Controls nicht mehr sinnvoll dargestellt werden.

Name

Typ = [System.String]

Name legt den internen Namen des Formulars fest.

$form.Name = "MainForm"

Der Name dient der Identifikation innerhalb des Programms und wird dem Benutzer nicht angezeigt.

Opacity

Typ = [System.Double]

Opacity bestimmt die Deckkraft des Fensters.

Der Wertebereich liegt zwischen 0 und 1.

$form.Opacity = 0.8

Standardwert = 1

Padding

Typ = [System.Windows.Forms.Padding]

Padding legt den Innenabstand zwischen dem Rand des Formulars und dessen Inhalt fest.

$form.Padding = [System.Windows.Forms.Padding]::new(10)

Der Wert wird insbesondere beim Layout der enthaltenen Controls berücksichtigt.

ShowIcon

Typ = [System.Boolean]

ShowIcon bestimmt, ob das Icon des Formulars in der Titelleiste angezeigt wird.

Standardwert = True

$form.ShowIcon = $false

ShowInTaskbar

Typ = [System.Boolean]

ShowInTaskbar bestimmt, ob das Formular als eigenes Fenster in der Windows-Taskleiste erscheint.

Standardwert = True

$form.ShowInTaskbar = $false

Dies kann beispielsweise bei Hilfs- oder Dialogfenstern sinnvoll sein.

Size

Typ = [System.Drawing.Size]

Size bestimmt die gesamte Größe des Formulars einschließlich Fensterrahmen und Titelleiste.

$form.Size = "800, 600"

Für die Größe des reinen Inhaltsbereichs sollte stattdessen ClientSize verwendet werden.

StartPosition

Typ = [System.Windows.Forms.FormStartPosition]

StartPosition bestimmt, wo das Formular beim ersten Anzeigen positioniert wird.

Typische Werte:

Beispiel:

$form.StartPosition = "CenterScreen"

Für Dialogfenster ist häufig CenterParent sinnvoll.

Text

Typ = [System.String]

Text bestimmt den Text in der Titelleiste des Formulars.

Standardwert = ""

$form.Text = "Meine Anwendung"

In deinem Windows-Setup-Helper wird der Titel beispielsweise beim Load-Event dynamisch erweitert.

TopMost

Typ = [System.Boolean]

TopMost bestimmt, ob das Formular dauerhaft über anderen normalen Fenstern angezeigt wird.

Standardwert = False

$form.TopMost = $true

Ein TopMost-Fenster bleibt über normalen Fenstern, auch wenn diese den Fokus erhalten.

WindowState

Typ = [System.Windows.Forms.FormWindowState]

WindowState bestimmt den aktuellen Zustand des Formulars.

Mögliche Werte:

$form.WindowState = "Maximized"

Der Standardwert ist:

Normal

Show()

$form.Show()

Zeigt das Formular an, ohne den aufrufenden Code zu blockieren.

Das Skript kann nach dem Aufruf weiterarbeiten.

ShowDialog()

$result = $form.ShowDialog()

Zeigt das Formular als modales Fenster an.

Der aufrufende Code wird angehalten, bis das Formular geschlossen wird.

Der Rückgabewert ist ein [System.Windows.Forms.DialogResult].

$result = $form.ShowDialog()

if ($result -eq "OK") {
    Write-Host "Bestätigt"
}

Zusammen mit AcceptButton, CancelButton und DialogResult lassen sich damit klassische Dialogfenster aufbauen.

Close()

$form.Close()

Schließt das Formular.

Bei einem Hauptformular kann das Schließen außerdem dazu führen, dass die Anwendung beendet wird, abhängig davon, wie die Windows-Forms-Anwendung gestartet wurde.

Hide()

$form.Hide()

Versteckt das Formular, ohne es zu zerstören.

Das Formular kann anschließend erneut mit Show() angezeigt werden.

$form.Hide()

# später
$form.Show()

Im Gegensatz zu Close() bleibt das Formular dabei bestehen.

Activate()

$form.Activate()

Aktiviert das Formular und versucht, es in den Vordergrund zu bringen.

Dies kann beispielsweise verwendet werden, wenn ein bereits geöffnetes Fenster erneut angezeigt werden soll.

CenterToScreen()

$form.CenterToScreen()

Positioniert das Formular in der Mitte des Bildschirms.

Alternativ kann bereits beim Start festgelegt werden:

$form.StartPosition = "CenterScreen"

CenterToParent()

$form.CenterToParent()

Zentriert das Formular relativ zu seinem übergeordneten Fenster.

Dies ist insbesondere für Dialogfenster sinnvoll.

Dispose()

$form.Dispose()

Gibt die vom Formular verwendeten Ressourcen frei.

Nach Dispose() sollte das Formular nicht weiterverwendet werden.

In deinem Setup-Helper wird beispielsweise das aktuelle Formular über Dispose() geschlossen und freigegeben, bevor der Prozess anschließend neu gestartet wird.