![]() |
CMSetProfileElementReference |
||||
Header: | CMApplication.h | Carbon status: | Supported | |
Adds a tag to the specified profile to refer to data corresponding to a previously set element.
CMError CMSetProfileElementReference ( CMProfileRef prof, OSType elementTag, OSType referenceTag );
A profile reference of type CMProfileRef to the profile to add the tag to.
The original elements signature tag corresponding to the element data to which the new tag will refer.
The new tag signature to add to the profile to refer to the element data corresponding to elementTag.
After the CMSetProfileElementReference function executes successfully, the specified profile will contain more than one tag corresponding to a single piece of data. All of these tags are of equal importance. Your application can set a reference to an element that was originally a reference itself without circularity.
If you call the function CMSetProfileElement subsequently for one of the tags acting as a reference to another tags data, then the element data you provide is set for the tag and the tag is no longer considered a reference. Instead, the tag corresponds to its own element data and not that of another tag.
Supported in Carbon. Available in Carbon 1.0.2 and later when ColorSync 2.0 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)