TableLayoutPanel.GetColumnSpan(Control) 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.

Zwraca liczbę kolumn obejmujących określoną kontrolkę podrzędną.

public:
 int GetColumnSpan(System::Windows::Forms::Control ^ control);

public int GetColumnSpan (System.Windows.Forms.Control control);

member this.GetColumnSpan : System.Windows.Forms.Control -> int

Public Function GetColumnSpan (control As Control) As Integer

Parametry

control: Control

Kontrolka podrzędna elementu TableLayoutPanel.

Zwraca

Int32

Liczba kolumn obejmujących kontrolkę podrzędną. Wartość domyślna to 1.

Przykłady

W poniższym przykładzie kodu użyto GetColumnSpan metod i SetColumnSpan w celu ustawienia szerokości Button kontrolki 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 w przypadku pozycjonowania kontrolki, która jest znacznie większa niż jej peers.

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

Dotyczy