Carbon


AlertStdAlertParamRec

Header: Dialogs.h

struct AlertStdAlertParamRec {
    Boolean movable; 
    Boolean helpButton; 
    ModalFilterUPP filterProc; 
    ConstStringPtr defaultText; 
    ConstStringPtr cancelText; 
    ConstStringPtr otherText; 
    SInt16 defaultButton; 
    SInt16 cancelButton; 
    UInt16 position;
};
typedef AlertStdAlertParamRec AlertStdAlertParamPtr;

Field descriptions

movable

A Boolean value indicating whether or not the alert box is movable.

helpButton

A Boolean value indicating whether or not the alert includes a Help button.

filterProc

If the value in the movable field is true (alert is movable), then specify in this parameter a universal procedure pointer to an application-defined filter function that responds to events not handled by ModalDialog. If you do, all events will get routed to your application-defined event filter function for handling, even when your alert box window is in the background. If you set this parameter to null, the Dialog Manager uses the standard event filter function.

defaultText

Text for button in OK position; see “Alert Default Text Constants”. The button automatically sizes and positions itself in the alert box. To specify that the default button names should be used, pass -1. To indicate that no button should be displayed, pass null.

cancelText

Text for button in Cancel position; see “Alert Default Text Constants”. The button automatically sizes and positions itself in the alert box. To specify that the default button names should be used, pass -1. To indicate that no button should be displayed, pass null.

otherText

Text for button in leftmost position; see “Alert Default Text Constants”. The button automatically sizes and positions itself in the alert box. To specify that the default button names should be used, pass -1. To indicate that no button should be displayed, pass null.

defaultButton

Specifies which button acts as the default button; see “Alert Button Constants”.

cancelButton

Specifies which button acts as the Cancel button (can be 0); see “Alert Button Constants”.

position

The alert box position, as defined by a window positioning constant. In this structure, the constant kWindowDefaultPosition is equivalent to the constant kWindowAlertPositionParentWindowScreen.

A standard alert structure of type AlertStdAlertParamRec can be used when you call the function StandardAlert to customize the alert box. The AlertStdAlertParamRec type is available with Appearance Manager 1.0 and later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)