Legacy Document

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.