Developer

API Reference

IDrawDecorator_SetExtent()

Brew Release
Brew MP 1.0.2
See Also
- WidgetExtent
- IDrawDecorator
- IDrawDecorator_GetPreferredExtent()
- IDrawDecorator_GetExtent()
- IWidget_SetPreferredExtent()
Description
Sets the horizontal and vertical extent of the draw decorator, independent of its preferred size. IDrawDecorator_SetExtent() tells the draw decorator the size it has been allocated on the display, and provides an opportunity for it to adjust its content as best suited for the allotted size. For example, a draw decorator that wraps a tab widget would likely cause that widget to reformat its contents to better suit the updated size of the draw decorator. As the extent of the draw decorator changes, so shall the layout, formatting and arrangement of all the objects held within. The new size assigned to the draw decorator MUST be honored by the draw decorator, its child widget, and all the children, grandchildren and the entire hierarchy of objects that may be contained within the child widget.
Parameters
  • p
    []:
    [in] Pointer to the IDrawDecorator object.
  • x
    []:
    [in] Pointer to the WidgetExtent struct that provides the new extent of the draw decorator.
Prototype
   void IDrawDecorator_SetExtent(IDrawDecorator *p, WidgetExtent *x);
   
Return
None
Side Effect
None
Comment
Subsequent call to IDrawDecorator_GetExtent() should return the same extent value sent in the call to IDrawDecorator_SetExtent().
  • Follow