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.
Parameters
  • 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
Comment
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.
  • Follow