TableLayoutPanel.SetRowSpan(Control, Int32) Metoda

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll
Źródło:
TableLayoutPanel.cs
Źródło:
TableLayoutPanel.cs
Źródło:
TableLayoutPanel.cs
Źródło:
TableLayoutPanel.cs
Źródło:
TableLayoutPanel.cs

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

W poniższym przykładzie kodu użyto GetRowSpan metod i SetRowSpan w celu ustawienia 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 w przypadku pozycjonowania kontrolki, która jest znacznie wyższa niż jej element równorzędny.

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

Dotyczy

Zobacz też