ListView.DrawColumnHeader 事件

定义

当绘制 ListView 的详细信息视图并且 OwnerDraw 属性设置为 true 时发生。

public:
 event System::Windows::Forms::DrawListViewColumnHeaderEventHandler ^ DrawColumnHeader;
public event System.Windows.Forms.DrawListViewColumnHeaderEventHandler DrawColumnHeader;
public event System.Windows.Forms.DrawListViewColumnHeaderEventHandler? DrawColumnHeader;
member this.DrawColumnHeader : System.Windows.Forms.DrawListViewColumnHeaderEventHandler 
Public Custom Event DrawColumnHeader As DrawListViewColumnHeaderEventHandler 

事件类型

示例

下面的代码示例提供了事件处理程序的 DrawColumnHeader 实现。 有关完整示例(包括事件处理程序的 DrawSubItem 实现),请参阅 OwnerDraw 参考主题。

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

注解

此事件允许使用所有者绘图自定义控件的外观 ListView 。 仅当 属性设置为 true 且 属性设置为 View.DetailsOwnerDraw,才会引发该View属性。 控件中的每个列标题都可能发生此事件。 有关所有者绘图的详细信息,请参阅 OwnerDraw 属性参考主题。

有关处理事件的详细信息,请参阅 处理和引发事件

适用于

另请参阅