API Reference | developer.brewmp.com API Reference | developer.brewmp.com

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().
Params
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.
Comments
The bitmap widget uses the IInterfaceModel interface to store the pointer passed to IWidget_SetBitmap.