Compartilhar via

Método IImageList2::Replace2 (commoncontrols.h)

  • Artigo

Substitui uma imagem em uma lista de imagens.

Sintaxe

HRESULT Replace2(
  [in]           int      i,
  [in]           HBITMAP  hbmImage,
  [in, optional] HBITMAP  hbmMask,
  [in, optional] IUnknown *punk,
  [in]           DWORD    dwFlags
);

Parâmetros

[in] i

Tipo: int

O índice da imagem a ser substituída.

[in] hbmImage

Tipo: HBITMAP

Um identificador para o bitmap que contém a imagem.

[in, optional] hbmMask

Tipo: HBITMAP

Um identificador para o bitmap que contém a máscara. Se nenhuma máscara for usada com a lista de imagens, esse parâmetro será ignorado.

[in, optional] punk

Tipo: IUnknown*

Um ponteiro para a interface IUnknown .

[in] dwFlags

Tipo: DWORD

Especifica como a máscara é aplicada à imagem como uma ou uma combinação bit a bit dos sinalizadores de decoração a seguir.

Valor Significado
ILR_DEFAULT
0x0000
 Não usado.
ILR_HORIZONTAL_LEFT
0x0000
 Alinhar horizontalmente à esquerda.
ILR_HORIZONTAL_CENTER
0x0001
 Centralizar horizontalmente.
ILR_HORIZONTAL_RIGHT
0x0002
 Alinhar horizontalmente à direita.
ILR_VERTICAL_TOP
0x0000
 Alinhar verticalmente à parte superior.
ILR_VERTICAL_CENTER
0x0010
 Alinhar verticalmente ao centro.
ILR_VERTICAL_BOTTOM
0x0020
 Alinhar verticalmente à parte inferior.
ILR_SCALE_CLIP
0x0000
 Não fazer nada.
ILR_SCALE_ASPECTRATIO
0x0100
 Dimensão.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
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]
Plataforma de Destino Windows
Cabeçalho commoncontrols.h
DLL Comctl32.dll (versão 6.0 ou posterior)