STM_SETIMAGE mensagem
Um aplicativo envia uma mensagem STM_SETIMAGE para associar uma nova imagem a um controle estático.
Parâmetros
-
wParam
-
Especifica o tipo de imagem a ser associada ao controle estático. Esse parâmetro pode usar um dos valores a seguir:
Valor Significado - IMAGE_BITMAP
Bitmap. - IMAGE_CURSOR
Cursor. - IMAGE_ENHMETAFILE
Meta-arquivo aprimorado. - IMAGE_ICON
Ícone. -
lParam
-
Manipule para a imagem a ser associada ao controle estático.
Valor retornado
O valor retornado é um identificador para a imagem anteriormente associada ao controle estático, se houver; caso contrário, será NULL.
Comentários
Para associar uma imagem a um controle estático, o controle deve ter o estilo adequado. A tabela a seguir mostra o estilo necessário para cada tipo de imagem.
| Tipo de Imagem | Estilo de controle estático |
|---|---|
| IMAGE_BITMAP | SS_BITMAP |
| IMAGE_CURSOR | SS_ICON |
| IMAGE_ENHMETAFILE | SS_ENHMETAFILE |
| IMAGE_ICON | SS_ICON |
Importante
Na versão 6 dos controles do Microsoft Win32, um bitmap passado para um controle estático usando o STM_SETIMAGE mensagem era o mesmo bitmap retornado por uma mensagem de STM_SETIMAGE subsequente. O cliente é responsável por excluir qualquer bitmap enviado a um controle estático.
Com o Windows XP, se o bitmap passado no STM_SETIMAGE mensagem contiver pixels com alfa diferente de zero, o controle estático usará uma cópia do bitmap. Esse bitmap copiado é retornado pela próxima mensagem de STM_SETIMAGE . O código do cliente pode rastrear independentemente os bitmaps passados para o controle estático, mas se ele não marcar e liberar os bitmaps retornados de mensagens STM_SETIMAGE, os bitmaps serão vazados.
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 |
|