CONTROL SET IMGBUTTON statement

Purpose

Change the icon or bitmap displayed in an IMAGE control. The new image is not re-sized to fit the size of the control.

Syntax

CONTROL SET IMGBUTTON hDlg, id&, newimage$

Remarks

hDlg refers to the dialog that owns the control.

id& is the unique control identifier as assigned to the control with the CONTROL ADD IMGBUTTON statement.

newimage$ specifies the name of the bitmap or icon in the resource file (.PBR). If the image resource uses an integer identifier, newimage$ should begin with a Number symbol (#), followed by the integer identifier in ASCII format. For example, "#998". Otherwise, the text identifier name should be used.

Restrictions

Images can only be exchanged with images of the same type. That is, if the control is displaying a bitmap then the replacement image must also be a bitmap. If the control is displaying an icon, the replacement image must also be an icon. For best results, icons should be 32x32 pixels.

When an image is changed, CONTROL SET IMGBUTTON automatically releases the old image from memory. Previous versions of PowerBASIC placed the onus on the programmer to release the old image handle.