Compartilhar via

DrawListViewColumnHeaderEventArgs.Header Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém o ColumnHeader que representa o cabeçalho de coluna a ser desenhado.

public:
 property System::Windows::Forms::ColumnHeader ^ Header { System::Windows::Forms::ColumnHeader ^ get(); };
public System.Windows.Forms.ColumnHeader Header { get; }
public System.Windows.Forms.ColumnHeader? Header { get; }
member this.Header : System.Windows.Forms.ColumnHeader
Public ReadOnly Property Header As ColumnHeader

Valor da propriedade

ColumnHeader

A ColumnHeader representação do cabeçalho da coluna.

Exemplos

O exemplo de código a seguir demonstra como usar a Header propriedade em um aplicativo que fornece desenho personalizado para um ListView controle.

Para obter o exemplo completo, consulte o DrawListViewColumnHeaderEventArgs tópico de referência de visão geral.

// Draws column headers.
private void listView1_DrawColumnHeader(object sender,
    DrawListViewColumnHeaderEventArgs e)
{
    using (StringFormat sf = new StringFormat())
    {
        // Store the column text alignment, letting it default
        // to Left if it has not been set to Center or Right.
        switch (e.Header.TextAlign)
        {
            case HorizontalAlignment.Center:
                sf.Alignment = StringAlignment.Center;
                break;
            case HorizontalAlignment.Right:
                sf.Alignment = StringAlignment.Far;
                break;
        }

        // Draw the standard header background.
        e.DrawBackground();

        // Draw the header text.
        using (Font headerFont =
                    new Font("Helvetica", 10, FontStyle.Bold))
        {
            e.Graphics.DrawString(e.Header.Text, headerFont,
                Brushes.Black, e.Bounds, sf);
        }
    }
    return;
}

' Draws column headers.
Private Sub listView1_DrawColumnHeader(ByVal sender As Object, _
    ByVal e As DrawListViewColumnHeaderEventArgs) _
    Handles listView1.DrawColumnHeader

    Dim sf As New StringFormat()
    Try

        ' Store the column text alignment, letting it default
        ' to Left if it has not been set to Center or Right.
        Select Case e.Header.TextAlign
            Case HorizontalAlignment.Center
                sf.Alignment = StringAlignment.Center
            Case HorizontalAlignment.Right
                sf.Alignment = StringAlignment.Far
        End Select

        ' Draw the standard header background.
        e.DrawBackground()

        ' Draw the header text.
        Dim headerFont As New Font("Helvetica", 10, FontStyle.Bold)
        Try
            e.Graphics.DrawString(e.Header.Text, headerFont, _
                Brushes.Black, e.Bounds, sf)
        Finally
            headerFont.Dispose()
        End Try

    Finally
        sf.Dispose()
    End Try

End Sub

Comentários

Essa propriedade é útil quando a State propriedade não fornece informações adequadas para atender às suas necessidades. A State propriedade fornece apenas informações básicas de estado que você pode usar, por exemplo, para determinar se o mouse está sobre o cabeçalho da coluna. A Header propriedade, por outro lado, permite que você acesse todos os membros do ColumnHeader cabeçalho que representa.

Aplica-se a

Confira também