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

Confira também

STM_GETIMAGE