NAME

set_pick_traversal_control − insert a pick traversal control element into the currently open segment

SYNOPSIS

C Syntax:

void set_pick_traversal_control(fildes, control)
int fildes, control;

FORTRAN77 Syntax:

subroutine set_pick_traversal_control(fildes, control)
integer*4 fildes, control

Pascal Syntax:

procedure set_pick_traversal_control(fildes, control:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened. 

control Indicates the type of control to be exerted over traversal. 

Discussion

Set_pick_traversal_control inserts a set_pick_traversal_control element into the currently open segment.  This element controls the traversal of the segment network by pick_from_segment(3G). 

Control can have one of the following values:

TRAVERSAL_RETURN Return from the segment currently being traversed.  This has the effect of making the rest of this segment and the segments it references not pickable. 

TRAVERSAL_ABORT Stop the traversal immediately. 

TRAVERSAL_CONTINUE Continue traversing the segment network.  Has no effect on the traversal. 

Values other than those listed generate an error. 

ERRORS

1 Graphics device not initialized for this operation. 

20 Parameter value is out of range. 

24 Segment not open. 

SEE ALSO

pick_from_segment(3G), set_pick_mode(3G). 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994