TmGetGraelRectangle Function

Returns the rectangular boundary of a graphical element.

Usage

rect = TmGetGraelRectangle(tool_name, grael_name)

Parameters

tool_name—A string containing the unique name of a VDA Tool.

grael_name—A string containing the name of the graphical element.

Returned Value

rect—A four-element array defining the endpoints of a rectangle in device coordinates: [x1 y1 x2 y2].

Keywords

None.

Discussion

The rectangular boundary is a region in which the user can click to select the graphical element. This rectangle is also the highlighted border that indicates when a graphical element has been selected.

Example

First, the graphical elements for a VDA Tool are enumerated. Then, the coordinates of the bounding rectangle for one of the graphical elements is returned by TmGetGraelRectangle.

PRINT, TmEnumerateGraels('WzPlot_0')
PRINT, TmGetGraelRectangle('WzPlot_0', 'AXIS_0')
; PV-WAVE prints: 50.0025      38.0034      492.003      58.0034

See Also

TmAddGrael, TmDelGrael, TmEnumerateGraels, TmGetUniqueGraelName, TmSetGraelRectangle