NM_CUSTOMDRAW (ヘッダー) 通知コード

  • [アーティクル]

ヘッダー コントロールによって送信され、描画操作について親ウィンドウに通知されます。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMCUSTOMDRAW) lParam;

パラメーター

lParam

描画操作に関する情報を含む NMCUSTOMDRAW 構造体へのポインター。 この構造体の dwItemSpec メンバーには、描画されるアイテムのインデックスが含まれ、この構造体の lItemlParam メンバーにはアイテムの lParam が含まれています。

戻り値

アプリケーションが返すことができる値は、現在の描画ステージによって異なります。 関連付けられた NMCUSTOMDRAW 構造体の dwDrawStage メンバーは、描画ステージを指定する値を保持します。 次のいずれかの値を返す必要があります。

リターン コード 説明
CDRF_DODEFAULT
 コントロール自体が描画されます。 このペイント サイクルに対 して追加のNM_CUSTOMDRAW メッセージは送信されません。 これは、 dwDrawStage が CDDS_PREPAINTと等しい場合に発生します。
CDRF_NOTIFYITEMDRAW
 コントロールは、アイテム関連の描画操作を親に通知します。 描画アイテムの前後NM_CUSTOMDRAW通知コードが送信されます。 これは、 dwDrawStage が CDDS_PREPAINTと等しい場合に発生します。
CDRF_NOTIFYPOSTERASE
 コントロールは、項目を消去した後に親に通知します。 これは、 dwDrawStage が CDDS_PREPAINTと等しい場合に発生します。
CDRF_NOTIFYPOSTPAINT
 コントロールは、項目の描画後に親に通知します。 これは、 dwDrawStage が CDDS_PREPAINTと等しい場合に発生します。
CDRF_NOTIFYSUBITEMDRAW
 一般的なコントロール バージョン。 コントロールは、リスト ビューサブ項目が描画されるときに親に通知します。 これは、 dwDrawStage が CDDS_PREPAINTと等しい場合に発生します。
CDRF_NEWFONT
 アプリケーションで項目の新しいフォントを指定しました。コントロールは新しいフォントを使用します。 フォントの変更の詳細については、「フォント と色の変更」を参照してください。 これは、 dwDrawStage が CDDS_ITEMPREPAINTと等しい場合に発生します。
CDRF_SKIPDEFAULT
 アプリケーションがアイテムを手動で描画しました。 コントロールは項目を描画しません。 これは、 dwDrawStage が CDDS_ITEMPREPAINTと等しい場合に発生します。

解説

詳細については、「 カスタム描画の使用 」を参照してください。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー
Commctrl.h