BM_SETIMAGE mensagem

Associa uma nova imagem (ícone ou bitmap) ao botão.

Parâmetros

wParam

O tipo de imagem a ser associada ao botão. Esse parâmetro pode usar um dos valores a seguir:

  • IMAGE_BITMAP
  • IMAGE_ICON

lParam

Um identificador (HICON ou HBITMAP) para a imagem a ser associada ao botão.

Valor retornado

O valor retornado é um identificador para a imagem anteriormente associada ao botão, se houver; caso contrário, será NULL.

Comentários

A aparência do texto, um ícone ou ambos em um controle de botão depende dos estilos BS_ICON e BS_BITMAP e se a mensagem de BM_SETIMAGE é chamada. Os resultados possíveis são os seguintes:

BS_ICON ou conjunto de BS_BITMAP? BM_SETIMAGE chamado? Result
Yes Yes Mostrar somente ícone.
No Yes Mostrar ícone e texto.
Yes No Mostrar somente texto.
No No Mostrar somente texto

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

Confira também

BM_GETIMAGE