UpdtDialog

Efficient version of DrawDialog

#include <Dialogs.h> Dialog Manager

void UpdtDialog( theDialog, updtRgn );

DialogPtr theDialog ; identifies dialog window

RgnHandle updtRgn ; region to update; theDialog -> visRgn

UpdtDialog draws a specified portion of the contents of a dialog within its

enclosing window frame. It is needed rarely since DialogSelect and

ModalDialog redraw the dialog box automatically.

theDialog is the address of a DialogRecord; It identifies the dialog to be

displayed.

updtRgn is a handle leading to a variable-length Region structure. It

identifies which part of theDialog should be drawn.

Notes: UpdtDialog might be used in response to an activate or update event for a

dialog window for which you don't call DialogSelect or ModalDialog

(which perform screen updating automatically).

Typical usage would be to pass the dialog window's visRgn handle (see

GrafPort) as updtRgn and enclose the call with calls to BeginUpdate and

BeginUpdate( theDialog );

UpdtDialog( theDialog, theDialog->visRgn);

EndUpdate( theDialog );

This is a more efficient version of the DrawDialog function. Rather than

drawing the entire dialog and letting Quickdraw clip it, only those portions

of the dialog contained in updtRgn are drawn.

Referenced by (4):