TableLayoutPanel.GetColumnSpan(Control) Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Int32

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 à