Developer

API Reference

DRAWHANDLERDESC_Init()

Brew Release
Brew MP 1.0.2
Description
This macro initializes each of the fields of a DrawHandlerDesc data structure. An application implementing a draw decorator that provides its own draw or free callback routine should call DrawHandlerDesc_Init() after creating an instance of the draw decorator object.
Parameters
  • pdesc
    []:
    Pointer to a DrawHandlerDesc data structure, into which the macro will copy the remaining parameters.
  • ph
    []:
    Pointer to the callback function that BREW will call when drawing the the decorator. This routine will override the default drawing routine for the decorator, allowing an application to apply a custom rendering technique to the widget wrapped by the draw decorator object.
  • pv
    []:
    A pointer to private data allocated and managed by the caller that has registered the draw handler with the draw decorator. This data pointer is passed into the draw handler, as well as the free handler, providing each of these callbacks with access to this private storage.
  • pf
    []:
    Pointer to the callback function that BREW will call when freeing the memory associated with a draw decorator upon releasing the object. This gives the draw decorator the opportunity to release any private "deep" storage that may have been allocated by the object.
Prototype
   DrawHandlerDesc_Init(DrawHandlerDesc *pdesc, PFNDRAWHANDLER ph, void *pv, PFNFREEHANDLER pf);
Return
None
Side Effect
None
Comment
None
  • Follow