API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

ITRIGMLELEMENT_GETANCESTORWITH()

Brew Release
Brew MP 1.0.2
See Also
ITRIGMLELEMENT_AttachObject() ITRIGMLELEMENT_GetAttachedObject()
Description
Starting at this element, query the attached object for the given interface. If there is no attached object or the attached object doesn't support that interface, check at this element's parent, and continue walking up the tree until we find an element whose attached object does implement that interface.
This function is useful for finding elements with attached BUIW containers.
If found, the returned interface pointer is AddRef'd; the caller should release it.
Params
po
[]:
The element from which to start the search.
interfaceId
[]:
The ID of the interface for which to query the attached object.
ppInterface
[]:
On successful return, *ppInterface contains a pointer (which has been AddRef'd) to the desired interface on the attached object of the returned element.
Interface
  • ITRIGMLELEMENT
Prototype
  •    ITrigmlElement* ITRIGMLELEMENT_GetAncestorWith(ITrigmlElement* po, AEECLSID interfaceId, void** ppInterface);
    
Return
  •    A pointer to the nearest ancestor element whose attached object implements
       the given interface, or NULL if no such element exists.
    
Comments
None