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 the argument pathorder are DcTopFirst <DCTOPF> and DcBottomFirst <DCBOTF>.  DcTopFirst <DCTOPF> means that the pick path order starts with the largest group in the view containing the primitive object and ends with the picked primitive object itself.  DcBottomFirst <DCBOTF> is the reverse. 

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)

September 29, 2021