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.
[in] Pointer to the IContainer interface object that serves as the parent
to the widget to locate.
[in] Pointer to the IWidget object to be located, or a constant that implies
a particular widget within the container. The constants used to
identify a relative position for the widget to be located, are defined
WIDGET_ZTOPMOST - Locate the widget at the top of the container's widget stack.
WIDGET_ZBOTTOMMOST - Locate the widget at the bottom of the container's widget stack.
WIDGET_ZNORMAL - Locate the widget placed at the container's most normal layout
location. The base container treats the WIDGET_ZTOPMOST position
as the "normal" location.
[out] 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, IContainer_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.