ListView.DrawColumnHeader イベント

.NET Framework クラス ライブラリ リファレンス

ListView.DrawColumnHeader イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

ListView の詳細ビューが描画され、OwnerDraw プロパティが true に設定されている場合に発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event DrawColumnHeader As
 DrawListViewColumnHeaderEventHandler

Visual Basic (使用法)

Dim instance As ListView
Dim handler As DrawListViewColumnHeaderEventHandler

AddHandler instance.DrawColumnHeader, handler

C#

public event DrawListViewColumnHeaderEventHandler DrawColumnHeader

C++

public:
event DrawListViewColumnHeaderEventHandler^ DrawColumnHeader {
    void add (DrawListViewColumnHeaderEventHandler^ value);
    void remove (DrawListViewColumnHeaderEventHandler^ value);
}

J#

/** @event */
public void add_DrawColumnHeader (DrawListViewColumnHeaderEventHandler
 value)

/** @event */
public void remove_DrawColumnHeader (DrawListViewColumnHeaderEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントを利用すると、オーナー描画を使用して ListView コントロールの外観をカスタマイズできます。これは、OwnerDraw プロパティが true に設定され、View プロパティが View.Details に設定されている場合にだけ発生します。このイベントは、コントロールの各列ヘッダーに対して発生します。オーナー描画の詳細については、OwnerDraw プロパティのリファレンス トピックを参照してください。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

DrawColumnHeader イベント ハンドラの実装を提供するコード例を次に示します。DrawSubItem イベント ハンドラの実装を含む完全な例については、OwnerDraw のリファレンス トピックを参照してください。

Visual Basic

' 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

C#

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

C++

   // Draws column headers.
private:
   void listView1_DrawColumnHeader( Object^ /*sender*/, DrawListViewColumnHeaderEventArgs^
 e )
   {
      StringFormat^ sf = gcnew StringFormat;
      try
      {
         // 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.
         System::Drawing::Font^ headerFont = gcnew System::Drawing::Font( "Helvetica",10,FontStyle::Bold
 );
         try
         {
            e->Graphics->DrawString( e->Header->Text, headerFont, Brushes::Black,
 e->Bounds, sf );
         }
         finally
         {
            if ( headerFont )
               delete (IDisposable^)headerFont;
         }
      }
      finally
      {
         if ( sf )
            delete (IDisposable^)sf;
      }

      return;
   }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ListView クラス
ListView メンバ
System.Windows.Forms 名前空間
ColumnHeader クラス
DrawListViewColumnHeaderEventArgs クラス
DrawItem
DrawSubItem
ListView.OwnerDraw プロパティ
ListView.View プロパティ
View
その他の技術情報
イベントとデリゲート