DADiSP Worksheet Functions > Function Categories > Annotation > ISHANDLE

 

ISHANDLE

Purpose:

Returns a positive integer if the input is a text or shape handle.

Syntax:

ISHANDLE(val)

val

-

A series, scalar or string value to test.

Returns:

100 if the input is a shape handle, 200 if the input is a text handle, else 0.

Example:

W1: gsin(100, .01);

h = rectdraw(W1, 0.2, -0.5, 0.6, 1.0);

 

a = ishandle(h)

 

a == 100

 

The value 100 indicates the input is a handle to a shape object.

Example:

W1: gsin(100, .01);

h = text(W1, 0.2, 1.0, "Example Text");

 

b = ishandle(h)

 

b == 200

 

The value 200 indicates the input is a handle to a text object.

Example:

h = 100

c = ishandle(h)

 

c == 0

 

The value 0 indicates the input is not a handle to a shape or text object.

Remarks:

See FINDHANDLE to obtain the handles for specific graphic objects.

See Also:

CLEAR

DELETEHANDLE

FINDHANDLE