NoteAlert

Perform Alert, displaying icon noteIcon

#include <Dialogs.h> Dialog Manager

short NoteAlert( alertID, filterProc );

short alertID ; ID of an 'ALRT' type resource

ProcPtr filterProc ; address of custom event filter; NIL= standard

returns item number selected (-1 if alert not drawn)

NoteAlert is identical to Alert except that it displays the system noteIcon at

location (10,20)(42,52) in the alert window; i.e., in the upper lefthand

corner.

alertID is the ID of a type 'ALRT' resource. See Alert for details.

filterProc is the address of a custom filter routine. See Alert.

Returns: a 16-bit integer identifying what user action took place. It is one

of:

-1 The alert was not drawn (and nothing happened) because the

current stage of the alert indicated that this was appropriate.

an item number The user selected this item, either with the mouse or by

pressing Return or Enter.

Notes: The resource ID of the standard system "note icon" is defined in

DialogMgr.h as noteIcon = 1. It may look like one of these:

If you create an 'ICON' resource with an ID of 1 in your application

resource, you can override this icon. A more appropriate technique would

be to create an iconItem type item and put it in the 'DITL' for the 'ALRT'

alert template.

NoteAlert looks for an 'actb' with the same ID as the 'ALRT' resource.

(see Alert for details.)

Referenced by (10):