TableLayoutPanel.SetColumnSpan(Control, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает число столбцов, занимаемых дочерним элементом управления.
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)
Параметры
- control
- Control
Дочерний элемент управления для элемента TableLayoutPanel.
- value
- Int32
Количество занимаемых столбцов.
Исключения
Значение параметра value
меньше 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
, которое панель добавляет в дочерние элементы управления во время разработки.