>  Docs Center  >  IDL Reference  >  Object Graphics - Visualization  >  IDLgrROIGroup::PickRegion

IDLgrROIGroup::PickRegion

IDLgrROIGroup::PickRegion

Syntax | Return Value | Arguments | Keywords | Version History

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


5.3

Introduced

 



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us