Legacy Document

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.