Developer

API Reference

IWidget_SetBitmap()

Brew Release
Brew MP 1.0.2
See Also
- EVT_MDL_VALUE
- IInterfaceModel
- IWidget
- IBitmap
Description
This function stores a pointer to a bitmap in the model used by a bitmap widget. Neither the widget nor the model make a copy of the data -- i.e., the data continues to be owned and should be managed by the object that calls IWidget_SetBitmap().
Parameters
  • pif
    []:
    [in] A pointer to an IWidget object.
  • pib
    []:
    [in] Pointer to the bitmap image to be displayed by the bitmap widget.

Interface
Prototype
   int IWidget_SetBitmap(IWidget *pif, IBitmap *pib);
Return
   
   AEE_SUCCESS - The widget was able to successfully store the pointer to the bitmap
                 to be displayed
   AEE_EFAILED - The attempt to set the bitmap has failed.

Side Effect
Setting the bitmap of a bitmap widget by calling IWidget_SetBitmap() will cause BREW to send an EVT_MDL_VALUE ModelEvent to any object registered as a listener with the IInterfaceModel. Generally, this means that the bitmap widget will receive notification that its contents have changes and will redraw itself using the newly stored bitmap.
Comment
The bitmap widget uses the IInterfaceModel interface to store the pointer passed to IWidget_SetBitmap.
  • Follow