TableLayoutPanel.SetColumnSpan(Control, Int32) Methode

Definitie

Hiermee stelt u het aantal kolommen dat door het onderliggende besturingselement wordt beslaan.

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)

Parameters

control
Control

Een onderliggend besturingselement van de TableLayoutPanel.

value
Int32

Het aantal kolommen dat u wilt overspannen.

Uitzonderingen

value is kleiner dan 1.

Voorbeelden

In het volgende codevoorbeeld worden de GetColumnSpan en SetColumnSpan methoden gebruikt om de breedte van een Button besturingselement in een TableLayoutPanelbesturingselement in te stellen.

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

Opmerkingen

Kolomspanning is vaak handig voor het plaatsen van een besturingselement dat aanzienlijk breder is dan de peers.

Deze methode wordt aangeroepen door de ColumnSpan eigenschap, die het deelvenster toevoegt aan de onderliggende besturingselementen tijdens het ontwerp.

Van toepassing op

Zie ook