Compartilhar via

Método IImageList::ImageListSetStrip (mmc.h)

  • Artigo

O método IImageList::ImageListSetStrip permite que um usuário adicione uma faixa de ícones à lista de imagens usando um par de bitmaps (ícones grandes e pequenos), começando em um local identificado por nStartLoc.

Sintaxe

HRESULT ImageListSetStrip(
  [in] LONG_PTR *pBMapSm,
  [in] LONG_PTR *pBMapLg,
  [in] long     nStartLoc,
  [in] COLORREF cMask
);

Parâmetros

[in] pBMapSm

Alça HBITMAP do Win32 para a faixa de imagens de ícone pequena (16x16). O snap-in possui esse recurso e deve liberá-lo quando terminar. Um vazamento de memória de recurso ocorrerá se o snap-in não liberar o BMapSm.

[in] pBMapLg

Alça HBITMAP do Win32 para a faixa de imagens de ícone grande (32x32). O snap-in possui esse recurso e deve liberá-lo quando terminar. Um vazamento de memória de recurso ocorrerá se o snap-in não liberar BMapLg.

[in] nStartLoc

Um valor que especifica o índice atribuído à primeira imagem na faixa. Esse é um índice virtual mapeado internamente para o índice real.

[in] cMask

Um valor que especifica a cor usada para gerar uma máscara.

Valor retornado

Esse método pode retornar um desses valores.

Comentários

Bitmaps pequenos e grandes devem ser fornecidos e o número de ícones em cada faixa deve ser igual. O bitmap pequeno deve ter 16 pixels de altura e 16n pixels de largura, em que n é um valor inteiro. O bitmap grande deve ter 32 pixels de altura e 32n pixels de largura.

Cada pixel da cor usada para gerar uma máscara no bitmap especificado é alterado para preto e o bit correspondente na máscara é definido como um.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho mmc.h
DLL Mmcndmgr.dll

Confira também

IImageList