Resources | Resources |



Using blend widget

A blend widget is created by calling ISHELL_CreateInstance() and passing AEECLSID_CBlendWidget as the ClassID. If successful, a pointer to the blend widget object is returned in the ppobj parameter of ISHELL_CreateInstance().

Applications may control the degree to which the underlying widget is blended by setting the PROP_TRANSPARENCY property of the blend widget. A PROP_TRANSPARENCY value of 0 would produce a fully opaque result. A value of 1 would add a small degree of transparency to the widget. A Value of up to 255 can be used. 255 would render the widget completely transparent, or invisible. The default is to apply a completely transparent blend. Setting the PROP_TRANSPARENCY on a blend widget invalidates the widget's parent container.

To create a blend widget, an application would do the following.

  1. Call ISHELL_CreateInstance() with a ClassID of AEECLSID_CBlendWidget to retrieve a reference counted instance of the blend widget.
    ISHELL_CreateInstance(me->piShell, AEECLSID_CBlendWidget,
  2. If the blend widget is to be displayed with a degree of transparency, call IWidget_SetTransparency().
After a blend widget has been created, it can be used to affect the display of other widgets. Continuing the example above, the newly created blend widget could be attached as a decorator to the child widget you want to display with some level of transparency.