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 版。 正在繪製之子專案的索引。 如果要繪製主要專案，這個成員會是零。

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 版。  int 類型的值，指定要繪製之專案部分的標識碼。

iStateId

類型： int

6.0 版。  int 類型的值，指定要繪製之項目狀態的標識碼。

rcText

類型： RECT

6.0 版。RECT ，指定要繪製文字的矩形。

uAlign

類型： UINT

6.0 版。指定群組應如何對齊的 UINT。 這個成員可以是下列其中一個值。

值 意義
LVGA_HEADER_CENTER
 將群組置中。
LVGA_HEADER_LEFT
 將群組靠左對齊。
LVGA_HEADER_RIGHT
 對齊右邊的群組。

備註

注意 Comctl32.dll 第 6 版不可轉散發，但包含在 Windows 或更新版本中。 若要使用第 6 版 Comctl32.dll，請在指令清單中指定它。 如需指令清單的詳細資訊，請參閱 啟用可視化樣式。
 

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 commctrl.h