Freigeben über


TableLayoutPanel.GetColumnSpan(Control) Methode

Definition

Gibt die Anzahl der Spalten zurück, über die sich das angegebene untergeordnete Steuerelement erstreckt.

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 von TableLayoutPanel.

Gibt zurück

Die Anzahl der Spalten, über die sich das untergeordnete Steuerelement erstreckt. Der Standardwert ist 1.

Beispiele

Im folgenden Codebeispiel werden die GetColumnSpan Methoden und SetColumnSpan verwendet, um die Breite eines Button Steuerelements in einem 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

Die Spaltenspanne ist häufig nützlich, um ein Steuerelement zu positionieren, das erheblich breiter als seine Peers ist.

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

Gilt für:

Weitere Informationen