Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 |
|