ListView.DrawColumnHeader 事件

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

ListView.cs

當繪製 a ListView 的詳細視圖並將 OwnerDraw 屬性設為 true時，會發生這種情況。

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 

事件類型

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 外觀。 只有當屬性 OwnerDraw 被設定為 trueView 且 屬性被設定為 View.Details時，才會被提升。 此事件可針對控制項中的每個欄位標頭發生。 欲了解更多業主繪圖資訊，請參閱 OwnerDraw 物業參考主題。

如需處理事件的詳細資訊，請參閱 處理和引發事件。

另請參閱

• ColumnHeader
• DrawListViewColumnHeaderEventArgs
• DrawItem
• DrawSubItem
• OwnerDraw
• View
• View