TableLayoutPanel.SetColumnSpan(Control, Int32) Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
TableLayoutPanel.cs
Källa:
TableLayoutPanel.cs
Källa:
TableLayoutPanel.cs
Källa:
TableLayoutPanel.cs
Källa:
TableLayoutPanel.cs

Anger antalet kolumner som omfattas av den underordnade kontrollen.

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)

Parametrar

control
Control

En underordnad kontroll av TableLayoutPanel.

value
Int32

Antalet kolumner som ska sträcka sig över.

Undantag

ArgumentOutOfRangeException

value är mindre än 1.

Exempel

I följande kodexempel används GetColumnSpan metoderna och SetColumnSpan för att ange bredden på en Button kontroll i en 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

Kommentarer

Kolumnintervall är ofta användbart för att placera en kontroll som är betydligt bredare än dess peer-datorer.

Den här metoden anropas av egenskapen ColumnSpan , som panelen lägger till i sina underordnade kontroller vid designtillfället.

Gäller för

Se även