TableLayoutPanel.SetColumnSpan(Control, Int32) 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.

Définit le nombre de colonnes sur lesquelles s'étend le contrôle enfant.

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)

Paramètres

control: Control

Contrôle enfant de TableLayoutPanel.

value: Int32

Nombre de colonnes à étendre.

Exceptions

ArgumentOutOfRangeException

value est inférieur à 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 à