Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 6 - Dialog Manager / Dialog Manager Reference

Dialog Manager Routines / Creating Alerts

GetAlertStage
To determine the stage of the last occurrence of an alert, use the GetAlertStage function. The GetAlertStage function is also available as the GetAlrtStage function.
FUNCTION GetAlertStage: Integer;
DESCRIPTION
The GetAlertStage function returns a number from 0 to 3 as the stage of the last occurrence of an alert. For example, you can use the GetAlertStage function to
ensure that your application deactivates the active window only if an alert box is to be displayed at that stage.

ASSEMBLY-LANGUAGE INFORMATION
The global variable ACount contains this number. In addition, the global variable ANumber contains the resource ID of the alert resource of the last alert that occurred.

SEE ALSO
Listing 6-19 on page 6-66 illustrates how to use GetAlertStage to determine whether to deactivate a window for the current alert stage. Listing 6-2 on page 6-21 illustrates how to use an alert resource to specify different alert responses according to different alert stages.