Legacy Document

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.