Developer

API Reference

DrawHandlerDesc_Call()

Brew Release
Brew MP 1.0.2
See Also
- DrawHandlerDesc
- IDrawDecorator_SetDraw()
Description
This macro issues the drawing callback referenced by the draw handler descriptor passed to the function in the 'pdesc' parameter. An application that overrides a decorator's default draw routine by supplying a custom draw handler should ALWAYS call DrawHandlerDesc_Call() within its draw routine, passing in a pointer to the draw handler descriptor returned by IDrawDecorator_SetDraw() when the current draw handler was initially registered. The application providing a custom draw decorator consequently has the option of applying its own drawing operations prior to, or after, the default draw operation, depending on the needs of that particular draw decorator.
Parameters
  • pdesc
    []:
    Pointer to a DrawHandlerDesc data structure that contains a pointer to the draw handler BREW should execute.
  • canv
    []:
    Pointer to the ICanvas object onto which the draw handler will perform its drawing operations
  • x
    []:
    Horizontal position of the left side of the draw decorator, offset from the left side of the ICanvas object.
  • y
    []:
    Vertical position of the top of the draw decorator, offset from the top of the ICanvas object.
Prototype
   DrawHandlerDesc_Call(DrawHandlerDesc *pdesc, ICanvas *canv, int x, int y);
Return
None
Side Effect
None
Comment
None
  • Follow