ListView.DrawColumnHeader イベントとは何？わかりやすく解説 Weblio辞書

.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

public event DrawListViewColumnHeaderEventHandler DrawColumnHeader

C++

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

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

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