TableLayoutPanel.GetColumnSpan(Control) Methode

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Gibt die Anzahl der Spalten zurück, die vom angegebenen untergeordneten Steuerelement überspannt sind.

public:
 int GetColumnSpan(System::Windows::Forms::Control ^ control);
public int GetColumnSpan(System.Windows.Forms.Control control);
member this.GetColumnSpan : System.Windows.Forms.Control -> int
Public Function GetColumnSpan (control As Control) As Integer

Parameter

control
Control

Ein untergeordnetes Steuerelement der TableLayoutPanel.

Gibt zurück

Int32

Die Anzahl der Spalten, die vom untergeordneten Steuerelement überspannt sind. Die Standardeinstellung ist 1.

Beispiele

Im folgenden Codebeispiel werden die GetColumnSpan Und SetColumnSpan Methoden verwendet, um die Breite eines Steuerelements in einem Button Steuerelement TableLayoutPanelfestzulegen.

private void toggleSpanBtn_Click(
    System.Object sender, 
    System.EventArgs e)
{
    Control c = this.TableLayoutPanel1.GetControlFromPosition(0, 0);

    if ( c != null )
    {
        int xSpan = this.TableLayoutPanel1.GetColumnSpan(c);
        int ySpan = this.TableLayoutPanel1.GetRowSpan(c);

        if (xSpan>1)
        {
            xSpan = 1;
            ySpan = 1;
        }
        else
        {
            xSpan = 2;
            ySpan = 2;
        }

        this.TableLayoutPanel1.SetColumnSpan(c, xSpan);
        this.TableLayoutPanel1.SetRowSpan(c, ySpan);
    }
}

Private Sub toggleSpanBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles toggleSpanBtn.Click

    Dim c As Control = Me.TableLayoutPanel1.GetControlFromPosition(0, 0)

    If c IsNot Nothing Then

        Dim xSpan As Integer = Me.TableLayoutPanel1.GetColumnSpan(c)
        Dim ySpan As Integer = Me.TableLayoutPanel1.GetRowSpan(c)

        If xSpan > 1 Then

            xSpan = 1
            ySpan = 1

        Else

            xSpan = 2
            ySpan = 2

        End If

        Me.TableLayoutPanel1.SetColumnSpan(c, xSpan)
        Me.TableLayoutPanel1.SetRowSpan(c, ySpan)

    End If

End Sub

Hinweise

Spaltenübergreifende Spalten sind häufig nützlich, um ein Steuerelement zu positionieren, das deutlich breiter ist als seine Peers.

Diese Methode wird von der ColumnSpan Eigenschaft aufgerufen, die das Panel seinen untergeordneten Steuerelementen zur Entwurfszeit hinzufügt.

Gilt für:

Weitere Informationen