Release Date: 1 February 2008
Namedt_sethandle - specify the handle value for a named property
Generic Prototypedt_sethandle(dt_Handle, dt_String, dt_Handle) => dt_Boolean
C Prototype#include "dt_smiles.h"
dt_Boolean dt_sethandle(dt_Handle object, dt_Integer nlen, dt_String pname, dt_Handle value)
FORTRAN Prototypeinclude 'dt_f_smiles.inc'
logical dt_f_sethandle(object, pname, value)
DescriptionCauses the named property to be created or modified. Sets the value of the named property 'pname' to 'value'. Also sets the property type of the named property to be set to DX_PROP_HANDLE (returned by dt_proptype(3)).
Named properties can be set for any object in the toolkit. The properties are owned by the object, and become invalid if the object is deallocated. A property name may be any valid string (see dt_setstringvalue(3)).
Return ValueReturns the success (TRUE) or failure (FALSE) of the operation.
Related Topicsdt_handle(3) dt_proptype(3) dt_setstringvalue(3)