# TableLayoutPanel Ein `TableLayoutPanel` ist ein Layout-Container, der seine enthaltenen Controls in einem **Raster aus Zeilen und Spalten** anordnet. Im Gegensatz zu einem normalen `Panel` werden Controls nicht über ihre `Location` positioniert, sondern einer bestimmten Zelle innerhalb des Rasters zugewiesen. Das `TableLayoutPanel` übernimmt anschließend automatisch die Positionierung und Größenanpassung aller enthaltenen Controls. --- ## **Grundlagen** Ein `TableLayoutPanel` organisiert Controls in einem **Tabellenlayout**. - `Panel` → freie Positionierung über `Location` - `FlowLayoutPanel` → automatische Anordnung hintereinander - `TableLayoutPanel` → Anordnung in Zeilen und Spalten #### TableLayoutPanel erstellen ```powershell # Klassisch $table = New-Object System.Windows.Forms.TableLayoutPanel # .NET-Style $table = [System.Windows.Forms.TableLayoutPanel]::new() ``` #### Controls hinzufügen ```powershell $table.Controls.Add($button) ``` oder direkt in eine bestimmte Zelle ```powershell $table.Controls.Add($button, 1, 0) # Spalte 1, Zeile 0 ``` #### Zeilen und Spalten festlegen ```powershell $table.ColumnCount = 2 $table.RowCount = 3 ``` --- ## **Eigenschaften**
EigenschaftBeschreibung
`ColumnCount`Anzahl der Spalten.
`RowCount`Anzahl der Zeilen.
`ColumnStyles`Definiert Breite jeder Spalte.
`RowStyles`Definiert Höhe jeder Zeile.
`GrowStyle`Legt fest, wie neue Zeilen oder Spalten entstehen.
`CellBorderStyle`Zeichnet Rahmen zwischen den Zellen.
`Dock`Dockt das Panel an den Parent an.
`Anchor`Verankert das Panel am Parent.
`AutoSize`Passt die Größe automatisch an.
`AutoScroll`Aktiviert Scrollleisten.
`BackColor`Hintergrundfarbe.
`Padding`Innenabstand.
`Margin`Außenabstand.
`Name`Interner Name.
`Location`Position des Panels.
`Size`Größe des Panels.
`Visible`Sichtbarkeit.
`Enabled`Aktiviert bzw. deaktiviert das Panel.
AutoScroll ### **AutoScroll**
**Typ**`System.Boolean`
**Standardwert**`False`
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:** ```powershell $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 ### **AutoSize**
**Typ**`System.Boolean`
**Standardwert**`False`
Passt die Größe automatisch an den Inhalt an. **Beispiel:** ```powershell $table.AutoSize = $true ```
CellBorderStyle ### **CellBorderStyle**
**Typ**`System.Windows.Forms.TableLayoutPanelCellBorderStyle`
**Standardwert**`None`
Legt fest, ob zwischen den Zellen Rahmen gezeichnet werden. Mögliche Werte - `None` - `Single` - `Inset` - `Outset` - `InsetDouble` - `OutsetDouble` **Beispiel:** ```powershell $table.CellBorderStyle = "Single" ```
ColumnCount ### **ColumnCount**
**Typ**`System.Int32`
**Standardwert**`0`
Legt fest, aus wie vielen Spalten das Layout besteht. **Beispiel:** ```powershell $table.ColumnCount = 3 ```
ColumnStyles ### **ColumnStyles**
**Typ**`System.Windows.Forms.TableLayoutColumnStyleCollection`
**Standardwert**leere Sammlung
Bestimmt die Breite jeder einzelnen Spalte. Es gibt drei verschiedene Größenarten:
GrößeBeschreibung
`Absolute`Feste Pixelgröße
`Percent`Prozentuale Verteilung
`AutoSize`Größe richtet sich nach dem Inhalt
**Beispiel:** ```powershell $table.ColumnStyles.Add( [System.Windows.Forms.ColumnStyle]::new("Percent",50) ) $table.ColumnStyles.Add( [System.Windows.Forms.ColumnStyle]::new("Percent",50) ) ```
Dock ### **Dock**
**Typ**`System.Windows.Forms.DockStyle`
**Standardwert**`None`
Legt fest, wie das TableLayoutPanel innerhalb seines Parent-Containers angedockt wird. **Beispiel:** ```powershell $table.Dock = "Fill" ``` Dies ist die häufigste Einstellung.
GrowStyle ### **GrowStyle**
**Typ**`System.Windows.Forms.TableLayoutPanelGrowStyle`
**Standardwert**`AddRows`
Legt fest, wie das Panel reagiert, wenn mehr Controls hinzugefügt werden als Zellen vorhanden sind. Mögliche Werte - `AddRows` - `AddColumns` - `FixedSize` **Beispiel:** ```powershell $table.GrowStyle = "AddRows" ``` Bei `FixedSize` wird eine Ausnahme ausgelöst, wenn kein Platz mehr vorhanden ist.
RowCount ### **RowCount**
**Typ**`System.Int32`
**Standardwert**`0`
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:** ```powershell $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 ### **RowStyles**
**Typ**`System.Windows.Forms.TableLayoutRowStyleCollection`
**Standardwert**leere Sammlung
Bestimmt die Höhe jeder Zeile. Auch hier stehen - `Absolute` - `Percent` - `AutoSize` zur Verfügung. **Beispiel:** ```powershell $table.RowStyles.Add( [System.Windows.Forms.RowStyle]::new("AutoSize") ) ```
--- ## **Methoden**
MethodeBeschreibung
`GetControlFromPosition()`Liefert das Control einer bestimmten Zelle.
`GetPositionFromControl()`Liefert die Position eines Controls.
`GetColumn()`Liefert die Spalte eines Controls.
`GetRow()`Liefert die Zeile eines Controls.
`SetColumn()`Verschiebt ein Control in eine andere Spalte.
`SetRow()`Verschiebt ein Control in eine andere Zeile.
`SetColumnSpan()`Lässt ein Control mehrere Spalten belegen.
`SetRowSpan()`Lässt ein Control mehrere Zeilen belegen.
GetControlFromPosition() ### **GetControlFromPosition()** ```powershell $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() ### **GetPositionFromControl()** ```powershell $table.GetPositionFromControl($button) ``` **Beschreibung:** Ermittelt die aktuelle Position eines Controls innerhalb des Rasters. **Rückgabe:** Rückgabetyp `System.Windows.Forms.TableLayoutPanelCellPosition`
SetColumn() ### **SetColumn()** ```powershell $table.SetColumn($button,2) ``` Verschiebt ein Control in eine andere Spalte.
SetRow() ### **SetRow()** ```powershell $table.SetRow($button,1) ``` Verschiebt ein Control in eine andere Zeile.
SetColumnSpan() ### **SetColumnSpan()** ```powershell $table.SetColumnSpan($button,2) ``` Das Control erstreckt sich über mehrere Spalten.
SetRowSpan() ### **SetRowSpan()** ```powershell $table.SetRowSpan($button,3) ``` Das Control erstreckt sich über mehrere Zeilen.
### RowStyles
Insert #### **Insert()** ```powershell $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:** ```powershell $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.
--- ## **Events**
EventBeschreibung
`Layout`Wird ausgelöst, wenn das Layout neu berechnet wird.
`ControlAdded`Ein Control wurde hinzugefügt.
`ControlRemoved`Ein Control wurde entfernt.
---
Layout ### **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 ```powershell $table.Add_Layout({ Write-Host "Layout aktualisiert" }) ```
ControlAdded ### **ControlAdded** ```powershell $table.Add_ControlAdded({ param($sender,$e) Write-Host $e.Control.Name }) ``` Wird ausgelöst, sobald ein Control hinzugefügt wird.
ControlRemoved ### **ControlRemoved** ```powershell $table.Add_ControlRemoved({ param($sender,$e) Write-Host $e.Control.Name }) ``` Wird ausgelöst, sobald ein Control entfernt wird.
--- ## **Tipps & Tricks** ##### Controls direkt einer Zelle hinzufügen ```powershell $table.Controls.Add($button,0,1) ``` Dadurch entfällt ein späterer Aufruf von `SetColumn()` und `SetRow()`. --- ##### Control über mehrere Spalten strecken ```powershell $table.SetColumnSpan($textBox,2) ``` Dies wird häufig für Überschriften oder TextBoxen verwendet. --- ##### Gesamten verfügbaren Platz ausfüllen ```powershell $table.Dock = "Fill" ``` Das `TableLayoutPanel` wächst und schrumpft automatisch mit seinem Parent-Container. --- ##### Gleichmäßige Spalten erzeugen ```powershell $table.ColumnCount = 2 $table.ColumnStyles.Add( [System.Windows.Forms.ColumnStyle]::new("Percent",50) ) $table.ColumnStyles.Add( [System.Windows.Forms.ColumnStyle]::new("Percent",50) ) ``` Beide Spalten belegen dadurch jeweils die Hälfte der verfügbaren Breite