wb_set_image

bool wb_set_image (int wbobject, mixed source [, int transparentcolor [, int index [, int param]]])

Assigns the image source to the WinBinder object wbobject. Parameter source can be either an image, icon or cursor handle or a path to an image file name. If a handle, it must have been obtained with wb_create_image(), wb_create_mask() or wb_load_image(). The optional parameter transparentcolor tells the function which color is to be considered transparent. The default is NOCOLOR (no transparency). index is used to select a specific image from a multi-image file (such as a DLL or executable).

If source is an icon or a cursor, if param is 0 (the default), the function sets a large icon or cursor; if param is 1, it sets a small icon or cursor; if param is -1, the function sets the default icon or cursor. For minimized windows, this function will also change the icon that is displayed on the task bar.

Returns TRUE on success or FALSE if an error occurs.

Class-specific information

• In ListView and TreeView controls, param is the number of horizontal images contained in a multi-image bitmap.
• For ImageButton controls, param sets the number of images. Default is 1. See the topic on ImageButtons for more details.

See also

wb_create_image
wb_create_mask
wb_load_image
ImageButton class
Control functions
Image functions
Window functions