TableLayoutPanel.SetRowSpan(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 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

Freigeben über