lResult = SendMessage(
    // returns LRESULT in lResult
   (HWND) hWndControl,
    // handle to destination control
   (UINT) BM_SETIMAGE,
    // message ID
   (WPARAM) wParam,
    // = (WPARAM) () wParam;
   (LPARAM) lParam
    // = (LPARAM) () lParam;

);

Parameters

wParam

The type of image to associate with the button. This parameter can be one of the following values:

• IMAGE_BITMAP
• IMAGE_ICON

lParam

A handle to the image to associate with the button.

Return Value

Remarks

The appearance of text, an icon, or both on a button control depends on the BS_ICON and BS_BITMAP styles, and whether the BM_SETIMAGE message is called. The possible results are as follows:

BS_ICON or BS_BITMAP Set?	BM_SETIMAGE Called?	Result
Yes	Yes	Show icon only.
No	Yes	Show icon and text.
Yes	No	Show text only.
No	No	Show text only

Message Information

Header	Declared in Winuser.h, include Windows.h
Minimum operating systems	Windows 95, Windows NT 4.0

See Also

BM_GETIMAGE