TableLayoutPanel.SetColumnSpan(Control, Int32) Metode

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll
Sumber:
TableLayoutPanel.cs
Sumber:
TableLayoutPanel.cs
Sumber:
TableLayoutPanel.cs
Sumber:
TableLayoutPanel.cs
Sumber:
TableLayoutPanel.cs

Mengatur jumlah kolom yang terbenam oleh kontrol anak.

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)

Parameter

control
Control

Kontrol anak dari TableLayoutPanel.

value
Int32

Jumlah kolom yang akan dijangkau.

Pengecualian

ArgumentOutOfRangeException

value kurang dari 1.

Contoh

Contoh kode berikut menggunakan GetColumnSpan metode dan SetColumnSpan untuk mengatur lebar Button kontrol dalam 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

Keterangan

Rentang kolom sering berguna untuk memposisikan kontrol yang jauh lebih lebar daripada rekan-rekannya.

Metode ini dipanggil oleh ColumnSpan properti , yang ditambahkan panel ke kontrol turunannya pada waktu desain.

Berlaku untuk

Lihat juga