DADiSP Worksheet Functions > Function Categories > Data Type Conversion > CASTHANDLE

 

CASTHANDLE

Purpose:

Explicitly casts the input to an object handle.

Syntax:

CASTHANDLE(val)

val

-

A scalar, series or table.

Returns:

An integer object handle.

Example:

W1: 1..100;h1=text(30.0, 30.0, "Test Text")

h2 = castinteger(h1);

h3 = casthandle(h2);

 

argtype(h1) == 105

argtype(h2) == 1

argtype(h3) == 105

 

h1 is a handle to the text in W1.

h2 is an integer value

h3 is an object handle, identical to h1.

Remarks:

A handle is typically an integer value that refers to an ActiveX server, mode-less custom dialog box, text or shape annotation. See GETOBJECT and TEXT for more information on handles.

See Also:

ARGTYPE

CASTCOMPLEX

CASTREAL

CASTSERIES

CASTSTRING

CASTWINDOW