Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Associates a new image (icon or bitmap) with the button.
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 (HICON or HBITMAP) to the image to associate with the button.
Return value
The return value is a handle to the image previously associated with the button, if any; otherwise, it is NULL.
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 |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| Header |
|