DdInqPickPathOrder(3D)

NAME
DdInqPickPathOrder - Return the pick path order of a device

SYNOPSIS
C:
DtPickPathOrder DdInqPickPathOrder(device)
DtObject device;

FORTRAN:
INTEGER*4 DDQPPO(DEVICE)
INTEGER*4 DEVICE

DESCRIPTION
DdInqPickPathOrder returns the pick path order on the device, device. A device's pick path order specifies the order in which elements in the pick paths are returned on a device, device, by DdPickObjs <DDPO>. See DdSetPickCallback for a description of pick paths.

The two possible values returned for a device's pick path order are:

DcTopFirst  <DCTOPF>
    This 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>
    This pick path starts with the picked primitive object and ends with the group at the root of the same display tree.

Note: 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
DdInqPickPathOrder will fail if passed an invalid device handle; the returned value is undefined.

[WARNING - invalid device handle]

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