NMLVCUSTOMDRAW 構造体 (commctrl.h)

  • [アーティクル]

リスト ビュー コントロールによって送信される NM_CUSTOMDRAW (リスト ビュー) 通知コードに固有の情報が含まれます。

構文

typedef struct tagNMLVCUSTOMDRAW {
  NMCUSTOMDRAW nmcd;
  COLORREF     clrText;
  COLORREF     clrTextBk;
  int          iSubItem;
  DWORD        dwItemType;
  COLORREF     clrFace;
  int          iIconEffect;
  int          iIconPhase;
  int          iPartId;
  int          iStateId;
  RECT         rcText;
  UINT         uAlign;
} NMLVCUSTOMDRAW, *LPNMLVCUSTOMDRAW;

メンバー

nmcd

種類: NMCUSTOMDRAW

一般的なカスタム描画情報を含む NMCUSTOMDRAW 構造体。

clrText

種類: COLORREF

リスト ビュー コントロールでテキストの前景色を表示するために使用される色を表す COLORREF 値。

clrTextBk

種類: COLORREF

リスト ビュー コントロールでテキストの背景を表示するために使用される色を表す COLORREF 値。 バージョン 6.0 では、 LVM_SETBKIMAGE メッセージで背景画像が設定されている場合、このメンバーは無視されます。

iSubItem

型: int

バージョン 4.71。 描画されるサブ項目のインデックス。 メイン項目が描画されている場合、このメンバーは 0 になります。

dwItemType

型: DWORD

バージョン 6.0。   描画する項目の種類を含む DWORD。 このメンバーには、次のいずれかの値を指定できます。

値 意味
LVCDI_ITEM
 項目が描画されます。
LVCDI_GROUP
 グループが描画されます。
LVCDI_ITEMSLIST
 すべての項目が描画されます。

clrFace

種類: COLORREF

バージョン 6.0。項目の顔を表示するために使用される色を表す COLORREF 値。

iIconEffect

型: int

バージョン 6.0。  アイコンに適用される効果 (Glow、Shadow、Pulse など) を指定する int 型の値。

iIconPhase

型: int

バージョン 6.0。  アイコンのフェーズを指定する int 型の値。

iPartId

型: int

バージョン 6.0。  描画するアイテムの部分の ID を指定する int 型の値。

iStateId

型: int

バージョン 6.0。  描画するアイテムの状態の ID を指定する int 型の値。

rcText

種類: RECT

バージョン 6.0。テキストを描画する四角形を指定する RECT。

uAlign

型: UINT

バージョン 6.0。グループの配置方法を指定する UINT。 このメンバーには、次のいずれかの値を指定できます。

値 意味
LVGA_HEADER_CENTER
 グループを中央に配置します。
LVGA_HEADER_LEFT
 グループを左揃えにします。
LVGA_HEADER_RIGHT
 右側にグループを配置します。

注釈

バージョン 6 Comctl32.dll 再頒布可能ではありませんが、Windows 以降に含まれていることに注意してください。 バージョン 6 Comctl32.dll 使用するには、マニフェストで指定します。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。
 

要件

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