Developer

API Reference

IDrawDecorator_GetParent()

Brew Release
Brew MP 1.0.2
See Also
- IDrawDecorator Interface
- IContainer Interface
- IDrawDecorator_SetParent()
- IDecorator_GetParent()
- IWidget_GetParent()
Description
This function retrieves a pointer to the container object that serves as the parent to the draw decorator. Objects within the widget framework maintain a hierarchy of parent/child relationships, wherein a container may enclose and manage one or more child objects. The children of a parent container may be widgets, or additional containers and decorators, with each child receiving events and being managed by its parent.
IDrawDecorator_GetParent() inherits wholly from IDecorator_GetParent().
Parameters
  • p
    []:
    Pointer to the IDrawDecorator object.
  • ppc
    []:
    Pointer to an IContainer pointer, into which IDrawDecorator_GetParent() will return a pointer to the container that serves as the decorator's parent.
Prototype
   void IDrawDecorator_GetParent(IDrawDecorator *p, IContainer **ppc);
   
Return
A pointer to the draw decorator's parent container is returned in 'ppwc', or NULL if the draw decorator does not have a parent container.
Side Effect
None
Comment
The pointer passed in the 'ppc' parameter is a double-indirection -- i.e. it is a pointer to a pointer. Applications should use care in ensuring that the proper level of indirection is used in calling the function.
  • Follow