TableLayoutPanel.SetColumnSpan(Control, Int32) Methode

  • Referenz

Definition

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

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

Siehe auch