TableLayoutPanel.SetRowSpan(Control, Int32) Methode

  • Referenz

Definition

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

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

public:
 void SetRowSpan(System::Windows::Forms::Control ^ control, int value);
public void SetRowSpan (System.Windows.Forms.Control control, int value);
member this.SetRowSpan : System.Windows.Forms.Control * int -> unit
Public Sub SetRowSpan (control As Control, value As Integer)

Parameter

control
Control

Ein untergeordnetes Steuerelement von TableLayoutPanel.

value
Int32

Die Anzahl der zu einzunehmenden Zeilen.

Ausnahmen

ArgumentOutOfRangeException

value ist kleiner als 1.

Beispiele

Im folgenden Codebeispiel werden die GetRowSpan Und SetRowSpan 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

Zeilenspannen sind häufig nützlich, um ein Steuerelement zu positionieren, das erheblich höher ist als seine Peers.

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

Gilt für

Siehe auch