NAME

DsExecutionReturn − Abort traversal of the current group

SYNOPSIS

C:

void DsExecutionReturn()

FORTRAN:

CALL DSER()

DESCRIPTION

DsExecutionReturn causes traversal of the current group to abort.  Callback objects may conditionally affect traversal of display or definition hierarchies into which they are placed by calling DsExecutionReturn.  This halts traversal of the current group in which they are found. 

The execution of this group will halt only upon return from the callback function that called DsExecutionReturn.  In other words, the callback function will be allowed to finish, but no other objects in the same group will be executed after it. 

ERRORS

DsExecutionReturn will fail if called outside of a traversal method; the call to DsExecutionReturn will be ignored. 

[WARNING - no traversal in progress]

SEE ALSO

DoCallback(3D), DsExecuteObj(3D), DsExecutionAbort(3D)

September 02, 1992