Developer

API Reference

IDecorator_SetWidget()

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.

Qualcomm and Brew are trademarks of Qualcomm Incorporated, registered in the United States and other countries. Trademarks of Qualcomm Incorporated are used with permission. Other products and brand names may be trademarks or registered trademarks of their respective owners.