290 Chapter 12: Using iTool User Interface Elements
Prompts iTool Developer’s Guide
PromptUserText
The IDLitIMessaging::PromptUserText method displays a prompt string and a text-
entry field along with OK and Cancel buttons. In the standard iTool interface created
using the IDL widget toolkit, text prompts appear as modal dialogs as shown in
Figure 12-2.
Note
The PromptUserText function returns 1 if the user clicks the OK button, or 0 if the
user clicks the Cancel button.
The following code asks the user to enter a text string, which will be stored in the
variable
stringName:
status = self->PromptUsertext('Enter a string value', $
stringName, TITLE = 'Name the Created Object')
The value of the TITLE keyword is displayed in the title bar of the dialog box. The
variable
status will contain a 1 if the user clicks OK, or a 0 if the user clicks
Cancel.
