Developer

API Reference

ITRIGMLELEMENT_GetAttribute()

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_SetAttribute() ITRIGMLELEMENT_GetAttributeNoResolve() ITRIGMLELEMENT_GetIntAttribute() ITRIGMLELEMENT_GetStringAttribute()
Description
Resolves and returns the value of the given attribute on the given element.
Parameters
  • po
    []:
    The element for which to get the attribute.
  • classId
    []:
    The class ID of the attribute to get. This should be a KTrigml*ExtensionClassId constant from an extension metadata header.
  • id
    []:
    The attribute ID of the attribute to get. This should be a KTrigml*Attr* constant from an extension metadata header.
  • ppValue
    []:
    A pointer to receive the address of the resolved value of the attribute. The memory pointed to is owned by the Trigplayer; do not free it.
Interface
ITRIGMLELEMENT
Prototype
   int ITRIGMLELEMENT_GetAttribute(ITrigmlElement* po, AEECLSID classId, uint16 id, const TrigmlValue ** ppValue);
Return
   If the attribute exists on the element and its value was successfully
   resolved, the function will return SUCCESS and *ppValue will point to the
   resolved value of the attribute.
   If the attribute does not exist on the element, the function will return
   SUCCESS and *ppValue will be NULL.
   If the attribute exists on the element but could not be resolved, the
   function will return an appropriate non-SUCCESS error code.
Side Effect
Any observers of the attribute value will be notified with the new resolved attribute value. Attribute resolution can therefore be an expensive operation. Do not call ITRIGMLELEMENT_GetAttribute more often than is necessary.
Comment
None
  • Follow