Brew MP 1.0.2
This function will find the location of a particular widget, returning that widget's
rectangle relative to the widget's root container. The function will also, optionally,
return a pointer to the root container. Because each of the widgets managed by the
card container are treated as "cards" of equal size, ICardContainer_Locate() will
return a rectangle equal to the size of the card container's extent.
Pointer to the IContainer interface object that serves as the parent to
the widget to locate.
Pointer to the IWidget object to be located.
Pointer to an IContainer pointer, into which the function will return a
pointer to the container's root container. This parameter may be
specified as NULL if the caller does not wish to get the root container.
Pointer to an AEERect. On input, this rectangle will specify the current
relative offset of the 'pw' object relative to its child. On output,
this rectangle specifies the position of the object relative to the root
container. Therefore, ICardContainer_Locate() should initially be called
by passing in a rectangle with origin at (0, 0) -- otherwise, the
returned rectangle will be expressed relative to the initial offset.
int ICardContainer_Locate(ICardContainer* pif, IWidget* pw, IContainer** ppRoot, AEERect* prcRelative)