TableLayoutPanel.GetColumnSpan(Control) Метод

Определение

Возвращает число столбцов, занимаемых заданным дочерним элементом управления.

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

Параметры

control
Control

Дочерний элемент управления для элемента TableLayoutPanel.

Возвращаемое значение

Int32

Число столбцов, занимаемых дочерним элементом управления. Значение по умолчанию — 1.

Примеры

В следующем примере кода используются GetColumnSpan методы и SetColumnSpan методы для задания ширины Button элемента управления в .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

Комментарии

Диапазон столбцов часто полезен для размещения элемента управления, который значительно шире, чем его одноранговые узлы.

Этот метод вызывается свойством ColumnSpan , которое панель добавляет в дочерние элементы управления во время разработки.

Применяется к

См. также раздел