Структура NMTVASYNCDRAW (commctrl.h)

  • Статья

Содержит объяснение причины сбоя рисования значка или элемента дерева наложения. Эта структура отправляется в TVN_ASYNCDRAW уведомлении . Задайте элемент dwRetFlags , чтобы указать, какое действие должен предпринять элемент управления. Обратите внимание, что рисование может завершиться ошибкой, если нет изображения; иными словами, если изображение значка не было извлечено.

Синтаксис

typedef struct tagNMTVASYNCDRAW {
  NMHDR               hdr;
  IMAGELISTDRAWPARAMS *pimldp;
  HRESULT             hr;
  HTREEITEM           hItem;
  LPARAM              lParam;
  DWORD               dwRetFlags;
  int                 iRetImageIndex;
} NMTVASYNCDRAW;

Члены

hdr

Тип: NMHDR

Структура NMHDR.

pimldp

Тип: IMAGELISTDRAWPARAMS*

Структура IMAGELISTDRAWPARAMS , описывающая изображение, которое не удалось нарисовать.

hr

Тип: HRESULT

Код результата, указывающий, почему не удалось выполнить ничью( ILDRF_IMAGELOWQUALITY, ILDRF_OVERLAYLOWQUALITY, E_PENDING или S_OK. Код S_OK указывает, что изображение присутствует, но не имеет требуемого качества.

hItem

Тип: HTREEITEM

Дескриптор элемента дерева, который не удалось нарисовать.

lParam

Тип: LPARAM

Данные для hItem. Это те же данные для элемента, который извлекается с сообщением TVM_GETITEM с использованием соответствующей маски в структуре TVITEM. Эти данные являются родительскими; родительский объект может хранить сведения, помогающие идентифицировать элемент дерева или другие сведения. Данные предоставляются в lParam для удобства, поэтому родительскому объекту не нужно отправлять сообщения TVM_GETITEM.

dwRetFlags

Тип: DWORD

Действие, которое отправитель (элемент управления "Представление в виде дерева") должен выполнить при возврате. Значение должно иметь один из следующих флагов:

Значение Значение
ADRF_DRAWIMAGE
 Нарисуйте изображение, указанное в iRetImageIndex.
ADRF_DRAWSYNC
 Перейдите к рисованию изображения в любом случае, то есть синхронно извлечь изображение и закрасить. Если элемент управления находится в потоке пользовательского интерфейса, использование этого флага подразумевает низкоприоритетную производительность пользовательского интерфейса, так как время извлечения может отличаться, а пользовательский интерфейс может не отвечать на запросы в течение длительного периода времени во время извлечения.
ADRF_DRAWNOTHING
 Не рисуйте изображение.

iRetImageIndex

Тип: int

Индекс изображения для рисования в списке изображений. Используется, если ADRF_DRAWIMAGE возвращается в dwRetFlags.

Требования

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