Developer

API Reference

IDecorator_SetWidget()

Brew Release
Brew MP 1.0.2
See Also
- IDecorator_GetWidget()
- IDecorator
- IWidget
Description
This function wraps the decorator around a target widget, and makes the target widget the child of the decorator. Once wrapped, the decorator will provide management and visual services to the wrapped widget. For example, an application that wishes display stylized black and white photos of various Hollywood starlets (think, raven haired beauties like Audrey Hepburn, Winona Ryder, Brenda Marshall and Rachel Leigh Cook) with flashy, blinking marquee lighting around the frame of each photo. The application could create a special implementation of IDecorator -- the FlashyBlinkingMarquee Widget -- which it could then wrap around the StylizedBlackAndWhitePhoto Widget, by calling IDecorator_SetWidget() and passing in both the source decorator and the target widget. Now, each time that fetching photo of Vanessa Paradis pops onto the display, it will do so with Hollywood panache, surrounded by flashing, twinkling (I mean, blinking) lights.
Parameters
  • p
    []:
    [in] Pointer to the IDecorator object that will be wrapped around the target widget.
  • pw
    []:
    [in] Pointer to the target widget that will be managed by the decorator, or NULL if the decorator is to be completely detached from any child widgets.
Interface
Prototype
   void IDecorator_SetWidget(IDecorator *p, IWidget *pw)
Return
None
Side Effect
None
Comment
The reference count of the target widget 'w' will be incremented.
  • Follow