The IDLgrROIGroup::PickRegion function method picks a region within the group which, when projected onto the given destination device, is nearest to the given 2-D device coordinate.
Syntax
Result = Obj->[IDLgrROIGroup::]PickRegion( Dest, View, Point [, PATH=objref] )
Return Value
Returns the object reference of the nearest region. If two or more regions are equally nearest to the point, the one that was added to the region group first is returned.
Arguments
Dest
An object reference to an IDLgrWindow or IDLgrBuffer for which the pick is to occur.
View
An object reference to the IDLgrView containing this region.
Point
A two-element vector, [x, y], representing the device location to use for picking a nearest region.
Keywords
PATH
Set this keyword to a single object reference or a vector of object references. This keyword specifies the path in the graphics hierarchy to map the device position to a location in the data space of the region. Each path object reference specified with this keyword must contain an alias. The selected region is computed for the version of the object falling within the specified path. If this keyword is not set, the parent properties determine the path from the current object to the top of the graphics hierarchy and no alias paths are pursued.
Version History