DrawListViewColumnHeaderEventArgs.Header Eigenschaft

  • Referenz

Definition

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

Ruft den ColumnHeader ab, der den zu zeichnenden Spaltenkopf darstellt.

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

Eigenschaftswert

ColumnHeader

Der ColumnHeader, der den Spaltenkopf darstellt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Eigenschaft in einer Anwendung verwendet wird, die Header benutzerdefinierte Zeichnung für ein ListView Steuerelement bereitstellt.

Das vollständige Beispiel finden Sie im DrawListViewColumnHeaderEventArgs Übersichtsreferenzthema.

// 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

Hinweise

Diese Eigenschaft ist nützlich, wenn die State Eigenschaft keine ausreichenden Informationen zur Erfüllung Ihrer Anforderungen bereitstellt. Die State Eigenschaft stellt nur grundlegende Statusinformationen bereit, die Sie verwenden können, z. B. um zu bestimmen, ob die Maus über der Spaltenüberschrift liegt. Mit der Header Eigenschaft können Sie auf alle Member der ColumnHeader Kopfzeile zugreifen.

Gilt für

Siehe auch