Release Date: 1 February 2008
Namedt_label2 - retrieve a string label
Generic Prototypedt_label2(dt_Handle, dt_Handle) => dt_String
C Prototype#include "dt_depict.h"
dt_String dt_label2(dt_Integer *len, dt_Handle depiction, dt_Handle object)
FORTRAN Prototypeinclude 'dt_f_depict.inc'
integer*4 dt_f_label2(depiction, object, string)
DescriptionGets the second string label associated with the given object 'object' in the depiction 'depiction'. String labels may be associated with any constituent of the underlying molecule, including the molecule itself.
Depending on the type of the object 'object', the label will be used in different ways. The first atom label is drawn to the lower left of the atomic symbol. The two bond labels are drawn above and below the bond. Cycle labels are unused. Molecule labels are drawn above and below the entire depiction.
Return ValueReturns the string label or the 'invalid string' if the object in the given depiction does not have a label2 defined.
Related Topicsdt_label1(3) dt_label1ga(3) dt_label2ga(3) dt_setlabel1(3) dt_setlabel2(3) dt_setlabel1ga(3) dt_setlabel2ga(3)