CautionAlert

Perform Alert, displaying icon cautionIcon

#include <Dialogs.h> Dialog Manager

short CautionAlert( alertID, filterProc );

short alertID ; ID of an 'ALRT' type resource

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

returns item number (or -1)

CautionAlert is identical to Alert except that it displays the system

cautionIcon 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 an event filter or NIL. See Alert.

Returns: a 16-bit integer identifying what 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.

Notes: The resource ID of the standard system note icon is defined in DialogMgr.h

as cautionIcon = 2. It may look like one of these:

If you create an 'ICON' resource with an ID of 2 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.

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

(see Alert for details.)

Referenced by (11):