TableLayoutPanel.GetColumn(Control) Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Retorna a posição de coluna do controle filho especificado.

public:
 int GetColumn(System::Windows::Forms::Control ^ control);

public int GetColumn (System.Windows.Forms.Control control);

member this.GetColumn : System.Windows.Forms.Control -> int

Public Function GetColumn (control As Control) As Integer

Parâmetros

control: Control

Um controle filho do TableLayoutPanel.

Retornos

Int32

A posição de coluna do controle filho especificado ou -1, se a posição de control for determinada por LayoutEngine.

Exceções

ArgumentNullException

control é null.

NotSupportedException

control não é um tipo que pode ser organizado por esse LayoutEngine.

Exemplos

O exemplo de código a seguir enumera todos os controles filho no TableLayoutPanel índice de coluna para cada controle usando o GetColumn método.

private void getColumnBtn_Click(
    System.Object sender, 
    System.EventArgs e)
{
    foreach ( Control c in this.TableLayoutPanel1.Controls )
    {
        Trace.WriteLine(this.TableLayoutPanel1.GetColumn(c));
    }
}

Private Sub getColumnBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles getColumnBtn.Click

    Dim c As Control
    For Each c In Me.TableLayoutPanel1.Controls

        Trace.WriteLine(Me.TableLayoutPanel1.GetColumn(c))

    Next

End Sub

Comentários

Se control abranger duas ou mais colunas, o GetColumn método retornará o índice de coluna mais baixo.

O valor da posição da coluna é baseado em zero, portanto, você pode usá-lo como um índice para a matriz retornada por GetColumnWidths.

Esse método é chamado pela Column propriedade, que o painel adiciona aos controles filho em tempo de design.

Para obter a posição real de control, mesmo quando sua posição é determinada por LayoutEngine, chame o GetPositionFromControl método.

Aplica-se a

Partilhar via