TableLayoutPanel

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.