Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 6 - Dialog Manager / Dialog Manager Reference

Dialog Manager Routines / Handling Text in Alert and Dialog Boxes

GetDialogItemText
After using the GetDialogItem procedure to get a handle to an editable text item or a static text item in a dialog box, you can use the GetDialogItemText procedure to get the text string contained in that item. The GetDialogItemText procedure is also available as the GetIText procedure.
PROCEDURE GetDialogItemText (item: Handle; VAR text: Str255);
item
A handle to an editable text item or a static text item in a dialog box.
text
The text contained within the item.

DESCRIPTION
The GetDialogItemText procedure returns, in the text parameter, the text of the given editable text or static text item.

SPECIAL CONSIDERATIONS
If the user types more than 255 characters in an editable text item, GetDialogItemText returns only the first 255.

SEE ALSO
Listing 6-12 on page 6-49 illustrates how to use GetDialogItemText to retrieve
the text that a user types into an editable text item.