HideDItem

Move an item off screen; deactivate

#include <Dialogs.h> Dialog Manager

void HideDItem( theDialog, theItem );

DialogPtr theDialog ; the dialog containing item to hide

short theItem ; number of item to hide

HideDItem moves and item's rectangle off screen (and, if it is an editText

item, deactivates its TextEdit record).

theDialog is the address of a 170-byte DialogRecord structure. It identifies

which dialog contains the item you wish to hide. It is actually a

WindowPtr (a.k.a GrafPtr or cGrafPtr), normally obtained via

theItem identifies which item you wish to hide.

Notes: HideDItem and ShowDItem perform the useful operation of letting you

easily rearrange a single dialog for two or more purposes. For instance, a

text editor's "Find" and "Change" dialogs are enough alike to make it

convenient to use the same dialog for both; just hide the "Change to" portion

of the dialog to get input for a Find operation.

HideDItem moves the item's rectangle off screen by adding 16384 to both

the horizontal coordinates of the item's rectangle. If the current

coordinates are already greater than 8192, then HideDItem assumes the

item is already hidden and does nothing.

If theItem is an editText item, this function deactivates its TextEdit record

by calling TEDeactivate. It also erases the item's rectangle and adds it to

update region of theDialog.

You can create an initially-hidden item in the 'DITL' resource by adding

16384 to the left and right coordinates of its rectangle.

Referenced by (9):