Share via

Estrutura NMLVCUSTOMDRAW (commctrl.h)

  • Artigo

Contém informações específicas para um código de notificação de NM_CUSTOMDRAW (exibição de lista) enviado por um controle de exibição de lista.

Sintaxe

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;

Membros

nmcd

Tipo: NMCUSTOMDRAW

Estrutura NMCUSTOMDRAW que contém informações gerais de desenho personalizado.

clrText

Tipo: COLORREF

Valor COLORREF que representa a cor que será usada para exibir o primeiro plano de texto no controle de exibição de lista.

clrTextBk

Tipo: COLORREF

Valor COLORREF que representa a cor que será usada para exibir a tela de fundo do texto no controle de exibição de lista. Na versão 6.0., esse membro será ignorado se a imagem de plano de fundo estiver definida com a mensagem LVM_SETBKIMAGE .

iSubItem

Tipo: int

Versão 4.71. Índice do subitem que está sendo desenhado. Se o item main estiver sendo desenhado, esse membro será zero.

dwItemType

Tipo: DWORD

Versão 6.0.   DWORD que contém o tipo do item a ser desenhado. Esse membro pode ser um dos valores a seguir.

Valor Significado
LVCDI_ITEM
 Um item deve ser desenhado.
LVCDI_GROUP
 Um grupo deve ser desenhado.
LVCDI_ITEMSLIST
 Cada item deve ser desenhado.

clrFace

Tipo: COLORREF

Versão 6.0.Valor COLORREF que representa a cor que será usada para exibir a face de um item.

iIconEffect

Tipo: int

Versão 6.0.  Valor do tipo int que especifica o efeito aplicado a um ícone, como Brilho, Sombra ou Pulso.

iIconPhase

Tipo: int

Versão 6.0.  Valor do tipo int que especifica a fase de um ícone.

iPartId

Tipo: int

Versão 6.0.  Valor do tipo int que especifica a ID da parte de um item a ser desenhado.

iStateId

Tipo: int

Versão 6.0.  Valor do tipo int que especifica a ID do estado de um item a ser desenhado.

rcText

Tipo: RECT

Versão 6.0.RECT que especifica o retângulo no qual o texto deve ser desenhado.

uAlign

Tipo: UINT

Versão 6.0.UINT que especifica como um grupo deve ser alinhado. Esse membro pode ser um dos valores a seguir.

Valor Significado
LVGA_HEADER_CENTER
 Centralize o grupo.
LVGA_HEADER_LEFT
 Alinhe o grupo à esquerda.
LVGA_HEADER_RIGHT
 Alinhe o grupo à direita.

Comentários

Observe Comctl32.dll versão 6 não é redistribuível, mas está incluída no Windows ou posterior. Para usar Comctl32.dll versão 6, especifique-a em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.
 

Requisitos

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