TableLayoutPanel.SetColumnSpan(Control, Int32) Méthode

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Définit le nombre de colonnes étendues par 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 du TableLayoutPanel.

value
Int32

Nombre de colonnes à étendre.

Exceptions

ArgumentOutOfRangeException

value est inférieur à 1.

Exemples

L’exemple de code suivant utilise les méthodes et les GetColumnSpan méthodes pour définir la largeur d’un Button contrôle dans un TableLayoutPanel.SetColumnSpan

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 beaucoup 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