The IDLITSYS_CREATETOOL function creates an instance of the specified tool registered within the IDL Intelligent Tools system.
This routine is written in the IDL language. Its source code can be found in the file idlitsys_createtool.pro in the lib/itools subdirectory of the IDL distribution.
Result = IDLITSYS_CREATETOOL(StrTool [, DIMENSIONS=[width,height]] [, IDENTIFIER=variable] [, INITIAL_DATA=data] [, LOCATION=[x,y]] [, MACRO_NAMES=string or string array] [, /NO_SAVEPROMPT] [, OVERPLOT=iToolID] [, STYLE_NAME=string] [, USER_INTERFACE=string] [, VIEW_GRID=vector] [, /VIEW_NEXT] [, VIEW_NUMBER=number] [, VISUALIZATION_TYPE=vistype] )
Returns an iToolID that can be used to reference the created tool at a later time.
The name of a tool that has been registered with the iTools system via the ITREGISTER routine.
| Note |
Set this keyword to a two-element vector of the form [width, height] to specify the dimensions of the drawing area of the specific tool in device units. The minimum width of the window correlates to the width of the menubar. The minimum window height is 100 pixels.
Set this keyword to a named IDL variable that will contain the iToolID for the created tool. This value can then be used to reference this tool during overplotting operations or command-line-based tool management operations.
Set this keyword to the data objects that are used to create the initial visualizations in the created tool.
Set this keyword to a two-element vector of the form [x, y] to specify the location of the upper left-hand corner of the tool relative to the display screen, in device units.
| Note |
Set this keyword to a scalar string or an array of strings that specifies the names of one or more macros to run. The macro names are retrieved and the macros are run sequentially after the iTool and (if applicable) any visualizations have been created. If a macro of the specified name does not exist, IDL generates an error and the routine exits.
Set this keyword to cause the iTool not to prompt the user to save changes when closing the tool. The default is to prompt the user to save changes.
Set this keyword to the iToolID of the tool in which the visualization is to be created. This iToolID can be obtained during the creation of a previous tool or from the itGetCurrent routine.
Set this keyword equal to a string that specifies the name of a user-defined or a system style. If a style of the specified name does not exist, IDL generates an error and the routine exits. The style is applied to all items within all views and the current tool style is updated with the new style.
Set this keyword equal to a string containing the name of a custom user interface that was previously registered using the USER_INTERFACE keyword to the ITREGISTER procedure.
Set this keyword to a two-element vector of the form [columns, rows] to specify the view layout within the new tool. This keyword is only used if a new tool is being created; it is ignored if OVERPLOT, VIEW_NEXT, or VIEW_NUMBER are specified.
Set this keyword to change the view selection to the next view following the currently-selected view before issuing any graphical commands. If the currently-selected view is the last one in the layout, then /VIEW_NEXT will cause the first view in the layout to become selected. This keyword is ignored if no current tool exists.
| Note |
Set this keyword to change the currently-selected view to the view specified by the VIEW_NUMBER before issuing any graphical commands. The view number starts at 1, and corresponds to the position of the view within the graphics container (not necessarily the position on the screen). This keyword is ignored if no current tool exists.
| Note |
Set this keyword to a string containing the name of a registered visualization type that should be used to visualize any data specified by the INITIAL_DATA keyword. If this keyword is not specified, the iTool will select a visualization type based on the data type of the input data.
The following keywords are obsolete:
For information on obsolete keywords, See Obsolete Features.
Introduced: 6.0
MACRO_NAMES, STYLE_NAME keywords added: 6.1
ITREGISTER, Creating an iTool Launch Routine