ITT Rule IDL Version 7.0 User Manual download pdf (Page 340)

340 Chapter 15: Creating a Custom iTool Widget Interface

Creating the Interface Routine iTool Developer’s Guide

Creating the Interface Routine

The IDL procedure that creates your custom iTool widget interface will look much

like a widget creation routine from a traditional widget application. This section

points out some things you should be aware of.

Note

Code fragments used in this section, and those that follow, are taken from the

example custom interface developed in “Example: a Custom iTool Interface” on

page 360.

Routine Signature

Your widget creation routine should be an IDL procedure with a signature that looks

something like:

PRO example2_wdtool, oTool, TITLE = titleIn, $

LOCATION = location, $

VIRTUAL_DIMENSIONS = virtualDimensions, $

USER_INTERFACE = oUI, $ ; output keyword

_REF_EXTRA = _extra

where:

•

oTool is an object reference to the iTool that will use the interface.

•

TITLE is an optional keyword that specifies the title used for the iTool

window.

•

LOCATION is an optional keyword that specifies the location [x, y] in pixels on

the screen where the upper left corner of the interface should be positioned on

creation.

•

VIRTUAL_DIMENSIONS is an optional keyword that specifies the virtual size

of the iTool drawable area. Note that this size is not the same as the initial

visible size.

•

USER_INTERFACE is a required output keyword that returns an object

reference to the iTool user interface object created by the interface routine.

•

_REF_EXTRA is the standard keyword inheritance mechanism that allows the

routine that calls your user interface routine to pass additional keyword values

to the interface routine as needed.

Your routine may handle other keyword values as well.

1 2 ... 335 336 337 338 339 340 341 342 343 344 345 ... 429 430

No comments

ITT Rule IDL Version 7.0 User Manual Page 340