TableLayoutPanel.SetColumnSpan(Control, Int32) 方法

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll
來源:
TableLayoutPanel.cs
來源:
TableLayoutPanel.cs
來源:
TableLayoutPanel.cs
來源:
TableLayoutPanel.cs
來源:
TableLayoutPanel.cs

設定子控制項所跨越的欄位數量。

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)

參數

control
Control

一個子控。TableLayoutPanel

value
Int32

要跨越的欄位數量。

例外狀況

ArgumentOutOfRangeException

value 小於1。

範例

以下程式碼範例使用 和 GetColumnSpanSetColumnSpan 方法來設定控制項在 ButtonTableLayoutPanel.

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

備註

欄位跨度通常用於定位比對應控制點寬得多的控制項。

此方法由 ColumnSpan property 呼叫，面板在設計時將其加入子控制項。

適用於

另請參閱