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

SetDialogItemText
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 SetDialogItemText procedure to display a particular text string in that item. The SetDialogItemText procedure is also available as the SetIText procedure.
PROCEDURE SetDialogItemText (item: Handle; text: Str255);
item
A handle to an editable text item or a static text item in a dialog box.
text
The text to display in the item.

DESCRIPTION
The SetDialogItemText procedure places the specified text in the specified item and draws the item. This procedure is useful for supplying a default text string--such as a document name--for an editable text item while your application is running.

SPECIAL CONSIDERATIONS
All strings should be stored in resource files to ease translation into other languages.

SEE ALSO
For static text items, the ParamText procedure, described on page 6-122, is useful when you need to determine and provide only a portion of a text string while your application is running.