TableLayoutPanel.SetColumnSpan(Control, Int32) 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.

Legt die Anzahl der Spalten fest, über die sich das untergeordnete Steuerelement erstreckt.

public:
 void SetColumnSpan(System::Windows::Forms::Control ^ control, int value);

public void SetColumnSpan (System.Windows.Forms.Control control, int value);

member this.SetColumnSpan : System.Windows.Forms.Control * int -> unit

Public Sub SetColumnSpan (control As Control, value As Integer)

Parameter

control: Control

Ein untergeordnetes Steuerelement von TableLayoutPanel.

value: Int32

Die Anzahl der zu einzunehmenden Spalten.

Ausnahmen

ArgumentOutOfRangeException

value ist kleiner als 1.

Beispiele

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

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

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

Gilt für

Freigeben über