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;

Members

nmcd

型: NMCUSTOMDRAW

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

clrText

型: COLORREF

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

clrTextBk

型: COLORREF

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

iSubItem

型: int

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

dwItemType

型: DWORD

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

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

clrFace

型: COLORREF

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

iIconEffect

型: int

バージョン 6.0。  アイコンに適用される効果 (光彩、影、パルスなど) を指定する 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
 右側にグループを配置します。

注釈

Note Comctl32.dll バージョン 6 は再頒布できませんが、Windows XP 以降に含まれています。 バージョン 6 Comctl32.dll 使用するには、マニフェストで指定します。 マニフェストの詳細については、「Visual Stylesを有効にする」を参照してください。
 

Requirements

Requirement 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー commctrl.h
  • Last updated on