Syntax

[C/C++:]
void gEnqCursorAction(int *action, int *lverts, GPOINT *points);

[F90:]
subroutine gEnqCursorAction(action, lverts, points)

integer, intent(out) :: action,lverts
type (GPOINT), intent(out) :: points(*)

Arguments

action
Cursor action type

= GPOLYLINE,
= GDEFAULT,
= GRUBBERBAND,
= GRUBBERBOX,
= GRUBBERSQUARE,
= GRUBBERELLIPSE,
= GRUBBERCIRCLE,

lverts
Number of vertices if polyline cursor

points
Coordinates of polyline cursor

Description

The routine gEnqCursorAction() returns current setting for the cursor action type as set by gSetCursorAction(). The default cursor action type is for the currently defined cursor shape to follow the cursor or pointer position with no additional action.

If the current type is a user defined polyline cursor (action = GPOLYLINE) the coordinates are returned in points with the number of vertices returned in lverts. points should be declared as length 200 to contain the maximum possible number of points that could be returned by this routine. All other cursor action types return lverts as zero with no information in points.

The availability of cursor action types is hardware dependent and users should refer to the relevant Appendix B document for the current device being used.

See Also

gEnqCursorAction Usage
Device Drivers
gSetCursorAction

---