Export (0) Print
Expand All

STM_SETIMAGE message

An application sends an STM_SETIMAGE message to associate a new image with a static control.

Parameters

wParam

Specifies the type of image to associate with the static control. This parameter can be one of the following values:

ValueMeaning
IMAGE_BITMAP

Bitmap.

IMAGE_CURSOR

Cursor.

IMAGE_ENHMETAFILE

Enhanced metafile.

IMAGE_ICON

Icon.

 

lParam

Handle to the image to associate with the static control.

Return value

The return value is a handle to the image previously associated with the static control, if any; otherwise, it is NULL.

Remarks

To associate an image with a static control, the control must have the proper style. The following table shows the style needed for each image type.

Image typeStatic control style
IMAGE_BITMAPSS_BITMAP
IMAGE_CURSORSS_ICON
IMAGE_ENHMETAFILESS_ENHMETAFILE
IMAGE_ICONSS_ICON

 

Important  

In version 6 of the Microsoft Win32 controls, a bitmap passed to a static control using the STM_SETIMAGE message was the same bitmap returned by a subsequent STM_SETIMAGE message. The client is responsible to delete any bitmap sent to a static control.

With Windows XP, if the bitmap passed in the STM_SETIMAGE message contains pixels with nonzero alpha, the static control takes a copy of the bitmap. This copied bitmap is returned by the next STM_SETIMAGE message. The client code may independently track the bitmaps passed to the static control, but if it does not check and release the bitmaps returned from STM_SETIMAGE messages, the bitmaps are leaked.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

See also

STM_GETIMAGE

 

 

Community Additions

ADD
Show:
© 2014 Microsoft