DdSetPickPathOrder(3D)

NAME
DdSetPickPathOrder - Set the order of pick path elements returned to DdPickObjs

SYNOPSIS
C:
void DdSetPickPathOrder(device, pathorder)
DtObject device;
DtPickPathOrder pathorder;

FORTRAN:
CALL DDSPPO(DEVICE, PTHORD)
INTEGER*4 DEVICE
INTEGER*4 PTHORD

DESCRIPTION
DdSetPickPathOrder determines the order of the returned pick path elements when using DdPickObjs <DDPO> on the given device device. See DdSetPickCallback for a description of pick paths.

The valid values for pathorder are:

DcTopFirst <DCTOPF>
    The pick path starts with the group at the root of the display tree containing the picked primitive object and ends with the picked primitive object itself.

DcBottomFirst <DCBOTF>
    The pick path starts with the picked primitive itself and ends with the group at the root of the display tree containing the picked primitive object.

Note that the value of the pick path order affects only the order of pick path elements in paths returned from DdPickObjs <DDPO> and does NOT affect the order of elements as seen by the pick callback functions (see DdSetPickCallback).

ERRORS
DdSetPickPathOrder will fail if passed an invalid device handle.

[WARNING - invalid device handle]

DdSetPickCallback will fail if passed an invalid path order.

[WARNING - invalid pick path order]

DEFAULTS
The default pick path order is DcTopFirst <DCTOPF>.

SEE ALSO
DdInqPickPathOrder(3D), DdPickObjs(3D), DdSetPickCallback(3D)