TableLayoutPanel.GetColumnSpan(Control) Methode

Definitie

Retourneert het aantal kolommen dat wordt beslaan door het opgegeven onderliggende besturingselement.

public:
 int GetColumnSpan(System::Windows::Forms::Control ^ control);
public int GetColumnSpan(System.Windows.Forms.Control control);
member this.GetColumnSpan : System.Windows.Forms.Control -> int
Public Function GetColumnSpan (control As Control) As Integer

Parameters

control
Control

Een onderliggend besturingselement van de TableLayoutPanel.

Retouren

Het aantal kolommen dat wordt beslaan door het onderliggende besturingselement. De standaardwaarde is 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