Example

---

In the following example, we create three iPlot iTools and display the ID for each one. At the end, we set the first iTool created as the current iTool.

IPLOT, RANDOMU(seed, 30), IDENTIFIER = iToolID1, $        

   COLOR = [0, 0, 255]        

currentTool = IGETCURRENT()        

PRINT, 'The current tool is ', currentTool        

IPLOT, RANDOMU(seed, 30), IDENTIFIER = iToolID2, $        

   COLOR = [0, 255, 0]        

currentTool = IGETCURRENT()        

PRINT, 'The current tool is ', currentTool        

IPLOT, RANDOMU(seed, 30), IDENTIFIER = iToolID3, $        

   COLOR = [255, 0, 0]        

currentTool = IGETCURRENT()        

PRINT, 'The current tool is ', currentTool        

ISETCURRENT, iToolID1currentTool = IGETCURRENT()        

PRINT, 'The current tool is ', currentTool        

PRINT, 'The first tool is ', iToolID1            

Syntax

---

ISETCURRENT [, iToolID] [, /SHOW]

Arguments

---

iToolID

The identifier of the existing iTool to be set as current.

Keywords

---

SHOW

Set this keyword to set iToolID as the current tool, and ensure the tool is visible and has focus. If iToolID is not provided, the current iTool visualization is placed in front and given focus.

Version History

---

6.0	Introduced
7.1	Added the SHOW keyword. Routine name changed from ITCURRENT to ISETCURRENT.

See Also

---

IDELETE, IGETCURRENT, IRESET