NAME

set_disp_traversal_control − insert a display traversal control element into the currently open segment

SYNOPSIS

C Syntax:

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

FORTRAN77 Syntax:

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

Pascal Syntax:

procedure set_disp_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_disp_traversal_control inserts a set_disp_traversal_control element into the currently open segment of the specified graphics device.  This element controls the traversal of the segment network. 

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 invisible and unpickable. 

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 is not initialized for this operation. 

20 Parameter value is out of range. 

24 Segment not open. 

SEE ALSO

display_element(3G), display_segment(3G), display_segment_hsr(3G), pick_from_segment(3G), refresh_element(3G), refresh_segment(3G), refresh_segment_hsr(3G). 

Hewlett-Packard Company  —  HP-UX Release 10.0