NM_CUSTOMDRAW (ツリー ビュー) 通知コード

  • [アーティクル]

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

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMTVCUSTOMDRAW) lParam;

パラメーター

lParam

描画操作に関する情報を格納および受信する NMTVCUSTOMDRAW 構造体へのポインター。 この構造体の nmcd メンバーの dwItemSpec メンバーには、描画されるアイテムのハンドルが含まれています。 この構造体の nmcd メンバーの 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
 バージョン 4.71。 コントロールは、リスト ビューサブ項目が描画されるときに親に通知します。 これは、 dwDrawStage が CDDS_PREPAINTと等しい場合に発生します。
CDRF_NEWFONT
 アプリケーションで項目の新しいフォントを指定しました。コントロールは新しいフォントを使用します。 フォントの変更の詳細については、「フォント と色の変更」を参照してください。 これは、 dwDrawStage が CDDS_ITEMPREPAINTと等しい場合に発生します。
CDRF_SKIPDEFAULT
 アプリケーションがアイテムを手動で描画しました。 コントロールは項目を描画しません。 これは、 dwDrawStage が CDDS_ITEMPREPAINTと等しい場合に発生します。

解説

バージョン 5.80。 CDRF_NEWFONTを返してフォントを変更すると、ツリー ビュー コントロールにクリップされたテキストが表示されることがあります。 この動作は、以前のバージョンの共通コントロールとの下位互換性のために必要です。 ツリー ビュー コントロールのフォントを変更する場合は、コントロールに項目を追加する前に、wParam 値を 5 に設定してCCM_SETVERSION メッセージを送信すると、より良い結果が得られます。

必要条件

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

関連項目

カスタム描画の使用