Estrutura IMAGELISTDRAWPARAMS (commctrl.h)

  • Artigo

Contém informações sobre uma operação de desenho de lista de imagens e é usada com a função IImageList::D raw .

Sintaxe

typedef struct _IMAGELISTDRAWPARAMS {
  DWORD      cbSize;
  HIMAGELIST himl;
  int        i;
  HDC        hdcDst;
  int        x;
  int        y;
  int        cx;
  int        cy;
  int        xBitmap;
  int        yBitmap;
  COLORREF   rgbBk;
  COLORREF   rgbFg;
  UINT       fStyle;
  DWORD      dwRop;
  DWORD      fState;
  DWORD      Frame;
  COLORREF   crEffect;
} IMAGELISTDRAWPARAMS, *LPIMAGELISTDRAWPARAMS;

Membros

cbSize

Tipo: DWORD

O tamanho dessa estrutura, em bytes.

himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens que contém a imagem a ser desenhada.

i

Tipo: int

O índice de base zero da imagem a ser desenhada.

hdcDst

Tipo: HDC

Um identificador para o contexto do dispositivo de destino.

x

Tipo: int

A coordenada x que especifica onde a imagem é desenhada.

y

Tipo: int

A coordenada y que especifica onde a imagem é desenhada.

cx

Tipo: int

Um valor que especifica o número de pixels a serem desenhados, em relação ao canto superior esquerdo da operação de desenho, conforme especificado por xBitmap e yBitmap. Se cx e cy forem zero, Draw desenhará toda a seção válida. O método não garante que os parâmetros sejam válidos.

cy

Tipo: int

Um valor que especifica o número de pixels a serem desenhados, em relação ao canto superior esquerdo da operação de desenho, conforme especificado por xBitmap e yBitmap. Se cx e cy forem zero, Draw desenhará toda a seção válida. O método não garante que os parâmetros sejam válidos.

xBitmap

Tipo: int

A coordenada x que especifica o canto superior esquerdo da operação de desenho em referência à própria imagem. Pixels da imagem à esquerda de xBitmap e acima de yBitmap não aparecem.

yBitmap

Tipo: int

A coordenada y que especifica o canto superior esquerdo da operação de desenho em referência à própria imagem. Pixels da imagem à esquerda de xBitmap e acima de yBitmap não aparecem.

rgbBk

Tipo: COLORREF

A cor da tela de fundo da imagem. Esse parâmetro pode ser um valor RGB definido pelo aplicativo ou um dos valores a seguir.

Valor Significado
CLR_DEFAULT
 A cor da tela de fundo padrão. A imagem é desenhada usando a cor da tela de fundo da lista de imagens.
CLR_NONE
 Sem cor da tela de fundo. A imagem é desenhada de forma transparente.

rgbFg

Tipo: COLORREF

A cor de primeiro plano da imagem. Esse membro será usado somente se fStyle incluir o sinalizador ILD_BLEND25 ou ILD_BLEND50 . Esse parâmetro pode ser um valor RGB definido pelo aplicativo ou um dos seguintes valores:

Valor Significado
CLR_DEFAULT
 A cor de primeiro plano padrão. A imagem é desenhada usando a cor de realce do sistema como a cor de primeiro plano.
CLR_NONE
 Sem mistura de cores. A imagem é misturada com a cor do contexto do dispositivo de destino.

fStyle

Tipo: UINT

Um sinalizador que especifica o estilo de desenho e, opcionalmente, a imagem de sobreposição. Consulte a seção de comentários no final deste tópico para obter informações sobre a imagem de sobreposição. Esse membro pode conter um ou mais sinalizadores de desenho de lista de imagens.

dwRop

Tipo: DWORD

Um valor que especifica um código de operação de varredura. Esses códigos definem como os dados de cor do retângulo de origem serão combinados com os dados de cor do retângulo de destino para alcançar a cor final. Esse membro será ignorado se fStyle não incluir o sinalizador ILD_ROP . Alguns códigos de operação de varredura comuns incluem:

Valor Significado
ESCURIDÃO
 Preenche o retângulo de destino usando a cor associada ao índice zero na paleta física. (Essa cor é preta para a paleta física padrão.)
DSTINVERT
 Inverte o retângulo de destino.
MERGECOPY
 Mescla as cores do retângulo de origem com o padrão especificado usando o operador AND booliano.
MERGEPAINT
 Mescla as cores invertidas do retângulo de origem com as cores do retângulo de destino usando o operador OR booliano.
NOTSRCCOPY
 Copia o retângulo de origem invertido para o destino.
NOTSRCERASE
 Combina as cores do retângulo de origem e destino usando o operador OR booliano. Inverte a cor resultante.
PATCOPY
 Copia o padrão especificado no bitmap de destino.
PATINVERT
 Combina as cores de padrão especificadas com as cores do retângulo de destino usando o operador XOR booliano.
PATPAINT
 Combina as cores do padrão com as cores invertidas do retângulo de origem e combina o resultado com as cores do retângulo de destino usando o operador OR booliano.
SRCAND
 Combina as cores do retângulo de origem e destino usando o operador AND booliano.
SRCCOPY
 Copia o retângulo de origem diretamente para o retângulo de destino.
SRCERASE
 Combina as cores invertidas do retângulo de destino com as cores do retângulo de origem usando o operador AND booliano.
SRCINVERT
 Combina as cores do retângulo de origem e destino usando o operador XOR booliano.
SRCPAINT
 Combina as cores do retângulo de origem e destino usando o operador OR booliano.
BRANCURA
 Preenche o retângulo de destino usando a cor associada ao índice um na paleta física. Essa cor é branca para a paleta física padrão.

fState

Tipo: DWORD

Um sinalizador que especifica o estado do desenho. Esse membro pode conter um ou mais sinalizadores de estado de lista de imagens. Você deve usar comctl32.dll versão 6 para usar esse membro. Consulte os Comentários.

Frame

Tipo: DWORD

Usado com o efeito de mesclagem alfa .

Quando usado com ILS_ALPHA, esse membro mantém o valor do canal alfa. Esse valor pode variar de 0 a 255, sendo 0 completamente transparente e 255 completamente opaco.

Você deve usar comctl32.dll versão 6 para usar esse membro. Consulte os Comentários.

crEffect

Tipo: DWORD

Uma cor usada para os efeitos de brilho e sombra . Você deve usar comctl32.dll versão 6 para usar esse membro. Consulte os Comentários.

Comentários

Uma imagem de sobreposição é uma imagem desenhada sobre a imagem primária especificada no membro i dessa estrutura. Para especificar uma imagem de sobreposição, use o operador OR bit a bit para combinar fStyle com a macro INDEXTOOVERLAYMASK , passando o índice baseado em um da imagem de sobreposição na macro. Essa imagem deve ter sido especificada anteriormente como uma imagem de sobreposição usando a API ImageList_SetOverlayImage .

Para extrair a imagem de sobreposição do fStyle, use o operador AND bit a bit para mascarar fStyle com o valor ILD_OVERLAYMASK .

Comctl32.dll versão 6 não é redistribuível.. Para usar Comctl32.dll versão 6, especifique-a em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

   
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 (inclua Commctrl.h)