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)

September 02, 1992