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

Developer

API Reference

IWIDGET_SETCAPTURE()

Brew Release
Brew MP 1.0.2
See Also
IContainer_Locate() IWidget_SetPropertyEx()
Description
This inline method allows a widget to set or release capture mode. A widget which sets capture mode to true, gets all the future pen events ( ir-respective of the co-ordinates of the event) until either PEN_UP is received or the widget releases capture mode.
Params
pif
[]:
[in] A pointer to the IWidget interface
bCapture
[]:
[in] Specifies whether to set capture mode on or off (release capture)
Interface
  • IWIDGET
Prototype
  •    int   IWidget_SetCapture(IWidget *pif, boolean bCapture);
    
Return
  •    AEE_SUCCESS - If the requested operation was performed successfully( Set capture mode on or off)
       AEE_EFAILED - Otherwise
    
Side Effect
  • None
Comments
Note that the capure mode functionality actually belongs to RootContainer. This inline function uses IWidget_SetPropertyEx() to set the capture mode on the RootContainer. It is important that the widget be inserted in the RootContainer( directly or via some other container chain) before making this call.