Object Tag Object

CDXML Name:objecttag
CDX Constant Name:kCDXObj_ObjectTag
CDX Constant Value:0x8011
Contained by objects:kCDXObj_Group, kCDXObj_Fragment, kCDXObj_Node, kCDXObj_Bond, kCDXObj_Text, kCDXObj_Graphic, kCDXObj_Curve, kCDXObj_EmbeddedObject, kCDXObj_Table, kCDXObj_NamedAlternativeGroup, kCDXObj_Spectrum, kCDXObj_Geometry, kCDXObj_Constraint, kCDXObj_TLCPlate, kCDXObj_TLCLane, kCDXObj_TLCSpot
First written/read in:ChemDraw 6.0


Arbitrarily named property, one or more of which can be attached to any ChemDraw object. This object can be used to associate arbitrary data with an object.

An Object Tag may contain a Text object. If present, the Text object will be displayed in the document according to the state of its kCDXProp_Visible property. Object Tags of this type might be used as a visual display for some other property, such as a Node's or Bond's stereochemistry indicator.

Object tag names are critical to their management, since the name tells ChemDraw how to interpret the tag. All tags assigned internally by ChemDraw begin with the character sequence "/CS/CD/". Tags created for user purposes should begin with some other character sequence. Any ChemDraw object can have any number of tags attached to it, including multiple tags with the same name.

Spectrum-structure assignment is done by assigning an object tag with the name "/CS/CD/assign" to one or more atoms and a spectrum. The value of the tag is a string consisting of one or more ranges of x-axis values. The x-axis ranges define one or more bands or lines in the spectrum. The atoms containing a particular assignment are assigned to the bands specified. For example, in an IR spectrum, two atoms and the spectrum might all contain an object tag with the value "905.7-944.35,1123-1200" and a object tag dictionary index pointing to an object tag dictionary entry with the name "/CS/CD/assign" and the tag type kCDXObjectTagType_String. This will create an assignment between those two atoms and the bands lying between 905.7 and 944.35 cm-1, and 1123 and 1200 cm-1.

Although ChemDraw recognizes the types "unknown", "query" (for query indicators), "stereo" (for stereochemistry indicators), and "number" (for atom numbers), any sequence of bytes is a valid name. For unknown and user-defined types that contain a Text object, ChemDraw will faithfully display the tag, but no significance will be ascribed to the tag's text.

Object Tags require a Name, but have no required objects.

Value Name CDXML Name
0x8006 kCDXObj_Text t
An arbitrary block of (possibly styled) text.

Value Name CDXML Name Type
n/a n/a id UINT16
A unique identifier for an object, used when other objects refer to it.
0x0008 kCDXProp_Name Name CDXString
Required for objecttags. Name of an object.
0x0D00 kCDXProp_ObjectTag_Type TagType INT16
The tag's data type. This is an enumerated property.
0x0D03 kCDXProp_ObjectTag_Tracking Tracking CDXBoolean
The tag will participate in tracking if non-zero.
0x0D04 kCDXProp_ObjectTag_Persistent Persistent CDXBoolean
The tag will be resaved to a CDX file if non-zero.
0x0D05 kCDXProp_ObjectTag_Value Value varies
The value is a INT32, FLOAT64 or unformatted string depending on the value of ObjectTag_Type.
0x0D06 kCDXProp_Positioning PositioningType INT8
How the object should be positioned with respect to its containing object. This is an enumerated property.
0x0D07 kCDXProp_PositioningAngle PositioningAngle INT32
Angular positioning, in degrees * 65536.
0x0D08 kCDXProp_PositioningOffset PositioningOffset CDXPoint2D
Offset positioning.


CDX Documentation index