TableLayoutPanel.SetColumnSpan(Control, Int32) Metoda

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll
Zdroj:
TableLayoutPanel.cs
Zdroj:
TableLayoutPanel.cs
Zdroj:
TableLayoutPanel.cs
Zdroj:
TableLayoutPanel.cs
Zdroj:
TableLayoutPanel.cs

Nastaví počet sloupců rozložených podřízeným ovládacím prvku.

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

Podřízený ovládací prvek TableLayoutPanel.

value
Int32

Počet sloupců, které mají být rozloženy.

Výjimky

ArgumentOutOfRangeException

value je menší než 1.

Příklady

Následující příklad kódu používá GetColumnSpan a SetColumnSpan metody k nastavení šířky Button ovládacího prvku v objektu 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

Poznámky

Rozložení sloupců je často užitečné pro umístění ovládacího prvku, který je výrazně širší než jeho peers.

Tato metoda je volána ColumnSpan vlastností, kterou panel přidá do podřízených ovládacích prvků v době návrhu.

Platí pro

Viz také