Partager via


TableLayoutPanel.GetColumnSpan(Control) Méthode

Définition

Retourne le nombre de colonnes sur lesquelles s'étend le contrôle enfant spécifié.

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

Paramètres

control
Control

Contrôle enfant de TableLayoutPanel.

Retours

Nombre de colonnes sur lesquelles s'étend le contrôle enfant. La valeur par défaut est 1.

Exemples

L’exemple de code suivant utilise les GetColumnSpan méthodes et SetColumnSpan pour définir la largeur d’un Button contrôle dans un 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

Remarques

L’étendue des colonnes est souvent utile pour positionner un contrôle qui est considérablement plus large que ses homologues.

Cette méthode est appelée par la ColumnSpan propriété, que le panneau ajoute à ses contrôles enfants au moment du design.

S’applique à

Voir aussi