TableLayoutPanel.GrowStyle Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o controle TableLayoutPanel deverá ser expandido para acomodar novas células quando todas as células existentes forem ocupadas.
public:
property System::Windows::Forms::TableLayoutPanelGrowStyle GrowStyle { System::Windows::Forms::TableLayoutPanelGrowStyle get(); void set(System::Windows::Forms::TableLayoutPanelGrowStyle value); };
public System.Windows.Forms.TableLayoutPanelGrowStyle GrowStyle { get; set; }
member this.GrowStyle : System.Windows.Forms.TableLayoutPanelGrowStyle with get, set
Public Property GrowStyle As TableLayoutPanelGrowStyle
Valor da propriedade
Um TableLayoutPanelGrowStyle que indica o esquema de crescimento. O padrão é AddRows.
Exceções
O valor da propriedade é inválido para a enumeração TableLayoutPanelGrowStyle.
Exemplos
O exemplo de código a GrowStyle seguir define o valor da propriedade dependendo do selecionado RadioButton. Em tempo de execução, quando o usuário clica no botão rotulado Testar GrowStyle, um Button controle é adicionado ao TableLayoutPanel controle. Se o TableLayoutPanel controle estiver cheio, ele se expandirá adicionando uma linha ou coluna ou gerará uma exceção, dependendo do valor de GrowStyle.
private void growStyleNoneBtn_CheckedChanged(
System.Object sender,
System.EventArgs e)
{
this.tlpGrowStyle = TableLayoutPanelGrowStyle.FixedSize;
}
private void growStyleAddRowBtn_CheckedChanged(
System.Object sender,
System.EventArgs e)
{
this.tlpGrowStyle = TableLayoutPanelGrowStyle.AddRows;
}
private void growStyleAddColumnBtn_CheckedChanged(
System.Object sender,
System.EventArgs e)
{
this.tlpGrowStyle = TableLayoutPanelGrowStyle.AddColumns;
}
private void testGrowStyleBtn_Click(
System.Object sender,
System.EventArgs e)
{
this.TableLayoutPanel1.GrowStyle = this.tlpGrowStyle;
try
{
this.TableLayoutPanel1.Controls.Add(new Button());
}
catch(ArgumentException ex)
{
Trace.WriteLine(ex.Message);
}
}
Private Sub growStyleNoneBtn_CheckedChanged( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles growStyleNoneBtn.CheckedChanged
Me.tlpGrowStyle = TableLayoutPanelGrowStyle.FixedSize
End Sub
Private Sub growStyleAddRowBtn_CheckedChanged( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles growStyleAddRowBtn.CheckedChanged
Me.tlpGrowStyle = TableLayoutPanelGrowStyle.AddRows
End Sub
Private Sub growStyleAddColumnBtn_CheckedChanged( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles growStyleAddColumnBtn.CheckedChanged
Me.tlpGrowStyle = TableLayoutPanelGrowStyle.AddColumns
End Sub
Private Sub testGrowStyleBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles testGrowStyleBtn.Click
Me.TableLayoutPanel1.GrowStyle = Me.tlpGrowStyle
Try
Me.TableLayoutPanel1.Controls.Add(New Button())
Catch ex As ArgumentException
Trace.WriteLine(ex.Message)
End Try
End Sub
Comentários
Por padrão, o TableLayoutPanel controle se expande para baixo adicionando linhas.
Observação
Se for feita uma tentativa de adicionar um controle a um controle completo TableLayoutPanel , e o valor de GrowStyle é FixedSize, em seguida, um ArgumentException é gerado.