Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 6 - Dialog Manager / Dialog Manager Reference

Dialog Manager Routines / Manipulating Items in Alert and Dialog Boxes

ShowDialogItem

To redisplay an item that has been hidden by the HideDialogItem procedure, use the ShowDialogItem procedure. The ShowDialogItem procedure is also available as the ShowDItem procedure.

PROCEDURE ShowDialogItem (theDialog: DialogPtr; itemNo: Integer);

theDialog

A pointer to a dialog record.

itemNo

A number corresponding to the position of an item in the dialog box's item list resource.

DESCRIPTION

The ShowDialogItem procedure redisplays the item specified in itemNo by restoring the display rectangle the item had prior to the HideDialogItem call. Specifically, if
the left coordinate of the item's display rectangle is greater than 8192, ShowDialogItem subtracts 16,384 from both the left and right coordinates of the rectangle. If the item
is already visible (that is, if the left coordinate is less than 8192), ShowDialogItem
does nothing.

The ShowDialogItem procedure adds the rectangle that contained the item to the update region so that it will be drawn. Note that if the item is a control you define in a control ('CNTL') resource, the rectangle added to the update region is the rectangle defined in the control resource, not the display rectangle defined in the item list resource. If the item is an editable text item, ShowDialogItem activates it by calling the TextEdit procedure TEActivate.