TableLayoutPanel.SetRowSpan(Control, Int32) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Ustawia liczbę wierszy obejmujących kontrolkę podrzędną.

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)

Parametry

control: Control

Kontrolka podrzędna elementu TableLayoutPanel.

value: Int32

Liczba wierszy do przedziału.

Wyjątki

ArgumentOutOfRangeException

value wartość jest mniejsza niż 1.

Przykłady

Poniższy przykład kodu używa GetRowSpan metod i SetRowSpan do ustawiania szerokości kontrolki Button w obiekcie TableLayoutPanel.

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

Uwagi

Łączenie wierszy jest często przydatne do pozycjonowania kontrolki, która jest znacznie wyższa niż jej elementów równorzędnych.

Ta metoda jest wywoływana RowSpan przez właściwość, którą panel dodaje do kontrolek podrzędnych w czasie projektowania.

Dotyczy