TableLayoutPanel.SetColumnSpan(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ę kolumn obejmujących kontrolkę podrzędną.

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)

Parametry

control: Control

Kontrolka podrzędna elementu TableLayoutPanel.

value: Int32

Liczba kolumn do zakresu.

Wyjątki

ArgumentOutOfRangeException

value wartość jest mniejsza niż 1.

Przykłady

Poniższy przykład kodu używa GetColumnSpan metod i SetColumnSpan 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 kolumn jest często przydatne do pozycjonowania kontrolki, która jest znacznie szersza niż jej element równorzędny.

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

Dotyczy