TmDelSelectedGraels Procedure

Reference Guide > T Routines > TmDelSelectedGraels Procedure

Deletes a graphical element from the list of selected graphical elements.

Usage

TmDelSelectedGraels, tool_name, grael_name

Parameters

tool_name—A string containing the unique name of a VDA Tool from which the graphical element is to be removed.

grael_name—String containing the name of graphical element to remove.

Keywords

All—When specified and nonzero, deletes all selected graphical elements from the specified VDA Tool. This keyword supersedes the grael_name parameter.

Discussion

The graphical element selection list enables graphical elements to be cut, copied, pasted, and deleted from VDA Tools. To get a list of graphical elements associated with a given VDA Tool, use the TmEnumerateGraels function. To see which graphical elements are currently on the selection list, use TmEnumerateSelectedGraels.

note	If you specify the All keyword, you will delete all the graphical elements plus any other items that were defined for the VDA Tool. Use TmEnumerateSelectedGraels to return the list of all items to determine if the All keyword is appropriate.

Example

The first command returns all of the graphical elements currently on the selection list for the VDA Tool WzPlot_0. Then, one of the elements, RECTANGLE_0 is deleted from the list.

PRINT, TmEnumerateSelectedGraels('WzPlot_0')

   RECTANGLE_0 LINE_0 LINE_1

TmDelSelectedGraels, 'WzPlot_0', 'RECTANGLE_0'

PRINT, TmEnumerateSelectedGraels('WzPlot_0')

   LINE_0 LINE_1