The features described in this topic are obsolete
and should not be used in new IDL code.
ITCURRENT
The ITCURRENT procedure is used to set the current tool in the IDL Intelligent Tools system. This routine is used with the identifier of the tool to make it current in the system. If the identifier is valid, the specified tool becomes current.
When a tool is set as current, the visible display or the focus state of the tool does not change. Only the internal setting of the current tool changes.
Besides using this procedure to set the current tool, a tool is made current when it is created or when it is placed in focus in the current windowing system.
This routine is written in the IDL language. Its source code can be found in the file itcurrent.pro in the lib/itools subdirectory of the IDL distribution.
Syntax
ITCURRENT, iToolID
Arguments
iToolID
The identifier of the existing iTool to be set as current.
Keywords
None.
Example
Enter the following at the IDL Command Line:
IPLOT, IDENTIFIER = PlotID1
current1 = IGETCURRENT()
PRINT, 'The current tool is ', current1
An iPlot tool is created, and the newly created iPlot tool becomes the current tool. Output similar to the following appears in the IDL Output Log:
Enter the following at the IDL Command Line:
IPLOT, IDENTIFIER = PlotID2
current2 = IGETCURRENT()
PRINT, 'The current tool is ', current2
A second iPlot tool is created, and this newly created iPlot tool becomes the current tool. Output similar to the following appears in the IDL Output Log:
Enter the following at the IDL Command Line:
ISURFACE, IDENTIFIER = SurfaceID1
current3 = IGETCURRENT()
PRINT, 'The current tool is ', current3
An iSurface tool is created, and the newly created iSurface tool becomes the current tool. Output similar to the following appears in the IDL Output Log:
Enter the following at the IDL Command Line:
ITCURRENT, PlotID1
current = IGETCURRENT()
PRINT, 'The current tool is ', current
END
The iPlot tool created at the beginning of the example (PlotID1) becomes the current tool. Output similar to the following appears in the IDL Output Log:
Note that the system ID of the current tool (IPLOT_8) is the same as that of the current tool at the beginning of the exercise.
Version History
