TableLayoutPanel.GetColumnSpan(Control) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Int32

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: