StopAlert

Perform Alert, displaying icon stopIcon

#include <Dialogs.h> Dialog Manager

short StopAlert( alertID, filterProc );

short alertID ; ID of an 'ALRT' type resource

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

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

StopAlert is identical to Alert except that it displays the system stopIcon 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.

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 stop icon is defined in DialogMgr.h

as stopIcon = 0. It may look like one of these:

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

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

(see Alert for details.)

Referenced by (19):