Estrutura NMTVASYNCDRAW (commctrl.h)

Contém uma explicação de por que o desenho de um ícone ou item de árvore de sobreposição falhou. Essa estrutura é enviada em uma notificação de TVN_ASYNCDRAW . Defina o membro dwRetFlags para indicar qual ação o controle deve executar. Observe que um desenho pode falhar se não houver nenhuma imagem; em outras palavras, quando a imagem do ícone não tiver sido extraída.

Sintaxe

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

Membros

hdr

Tipo: NMHDR

Estrutura NMHDR.

pimldp

Tipo: IMAGELISTDRAWPARAMS*

Estrutura IMAGELISTDRAWPARAMS que descreve a imagem que não conseguiu desenhar.

hr

Tipo: HRESULT

Código de resultado que indica por que o desenho falhou, seja ILDRF_IMAGELOWQUALITY, ILDRF_OVERLAYLOWQUALITY, E_PENDING ou S_OK. Um código de S_OK indica que a imagem está presente, mas não na qualidade da imagem necessária.

hItem

Tipo: HTREEITEM

Identificador do item de árvore que não conseguiu desenhar.

lParam

Tipo: LPARAM

Dados para hItem. Esses são os mesmos dados para o item recuperado com a mensagem TVM_GETITEM usando a máscara apropriada na estrutura TVITEM. Esses dados são específicos do pai; o pai pode armazenar informações que ajudam a identificar o item de árvore ou outras informações. Os dados são fornecidos no lParam para conveniência, para que o pai não precise enviar mensagens TVM_GETITEM.

dwRetFlags

Tipo: DWORD

Ação que o remetente (o controle de exibição de árvore) deve executar no retorno. O valor deve ser um dos seguintes sinalizadores:

Valor	Significado
ADRF_DRAWIMAGE	Desenhe a imagem especificada por iRetImageIndex.
ADRF_DRAWSYNC	Continue a desenhar a imagem de qualquer maneira, ou seja, extraia a imagem e pinte de forma síncrona. Supondo que o controle esteja no thread da interface do usuário, o uso desse sinalizador implica um desempenho de interface do usuário de baixa prioridade, pois os tempos de extração podem variar e a interface do usuário pode não responder por um longo período de tempo durante a extração.
ADRF_DRAWNOTHING	Não desenhe uma imagem.

iRetImageIndex

Tipo: int

Índice da imagem a ser desenhada na lista de imagens. Usado se ADRF_DRAWIMAGE for retornado em dwRetFlags.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	commctrl.h