Developer

API Reference

ITRIGMLELEMENT_GetAncestorWith()

deprecated
Items marked as deprecated have been replaced by a more powerful, alternative feature. Deprecated interfaces include a reference to the replacement interface, which should be used for all new application development. Deprecated features are still supported for backward compatibility, but should be avoided when developing new applications.
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.
Parameters
  • 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.
Comment
None
  • Follow