Структура 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. Индекс рисуемого подэлемента. Если рисуется main элемент, этот элемент будет равен нулю.

dwItemType

Тип: DWORD

Версия 6.0.   DWORD , содержащий тип отрисовываемого элемента. Этот элемент может быть одним из следующих значений.

Значение Значение
LVCDI_ITEM
 Элемент должен быть нарисован.
LVCDI_GROUP
 Необходимо нарисовать группу.
LVCDI_ITEMSLIST
 Каждый элемент должен быть нарисован.

clrFace

Тип: COLORREF

Версия 6.0.Значение COLORREF , представляющее цвет, который будет использоваться для отображения лица элемента.

iIconEffect

Тип: int

Версия 6.0.  Значение типа int , указывающее эффект, применяемый к значку, например Glow, Shadow или Pulse.

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 или более поздней версии. Чтобы использовать Comctl32.dll версии 6, укажите его в манифесте. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.
 

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть commctrl.h