Udostępnij za pośrednictwem

TableLayoutPanel.SetColumnSpan(Control, Int32) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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

Zobacz też