CHeaderCtrl::DrawItem

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

オーナー描画のヘッダーコントロールの表示上の外観が変化したときに、フレームワークが呼び出します。

virtual void DrawItem(
   LPDRAWITEMSTRUCT lpDrawItemStruct 
);

パラメータ

lpDrawItemStruct
描画する項目を記述している DRAWITEMSTRUCT 構造体へのポインタ。

解説

DRAWITEMSTRUCT 構造体の itemAction メンバは、実行する描画動作を定義します。

既定では、このメンバ関数は何も実行しません。オーナー描画の CHeaderCtrl オブジェクトの描画を実装するには、このメンバ関数をオーバーライドします。

アプリケーションでは、このメンバ関数を終了する前に、lpDrawItemStruct で指定したディスプレイコンテキストに対して選択されているすべてのグラフィックデバイスインターフェイス (GDI) オブジェクトを元の状態に戻しておく必要があります。

使用例

// NOTE: CMyHeaderCtrl is a class derived from CHeaderCtrl.
// The CMyHeaderCtrl object was created as follows:
//
//   CMyHeaderCtrl m_myHeader;
//   myHeader.Create(WS_CHILD | WS_VISIBLE | HDS_HORZ,
//      CRect(10, 10, 600, 50), pParentWnd, 1);

// This example implements the DrawItem method for a 
// CHeaderCtrl-derived class that draws every item as a
// 3D button using the text color red.
void CMyHeaderCtrl::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
   // This code only works with header controls.
   ASSERT(lpDrawItemStruct->CtlType == ODT_HEADER);

   HDITEM hdi;
   const int c_cchBuffer = 256;
   TCHAR  lpBuffer[c_cchBuffer];

   hdi.mask = HDI_TEXT;
   hdi.pszText = lpBuffer;
   hdi.cchTextMax = c_cchBuffer;

   GetItem(lpDrawItemStruct->itemID, &hdi);

   // Draw the button frame.
   ::DrawFrameControl(lpDrawItemStruct->hDC, 
      &lpDrawItemStruct->rcItem, DFC_BUTTON, DFCS_BUTTONPUSH);

   // Draw the items text using the text color red.
   COLORREF crOldColor = ::SetTextColor(lpDrawItemStruct->hDC, 
      RGB(255,0,0));
   ::DrawText(lpDrawItemStruct->hDC, lpBuffer, 
      (int)_tcsnlen(lpBuffer, c_cchBuffer), 
      &lpDrawItemStruct->rcItem, DT_SINGLELINE|DT_VCENTER|DT_CENTER);
   ::SetTextColor(lpDrawItemStruct->hDC, crOldColor);
}