Daylight v4.9
Release Date: 1 February 2008

Name

dt_sethandle - specify the handle value for a named property

Generic Prototype

dt_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 Prototype

include 'dt_f_smiles.inc'

logical dt_f_sethandle(object, pname, value)

integer*4 object
character*() pname
integer*4 value

Description

Causes 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 Value

Returns the success (TRUE) or failure (FALSE) of the operation.

Related Topics

dt_handle(3) dt_proptype(3) dt_setstringvalue(3)