set_disp_traversal_control(3g)

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 by display_element(3G), display_segment(3G), display_segment_hsr(3G), pick_from_segment(3G). refresh_element(3G), refresh_segment(3G), and refresh_segment_hsr(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 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.

Museum

Related Articles