Legacy Documentclose button

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

Previous Book Contents Book Index Next

Inside Macintosh: Interapplication Communication /
Chapter 4 - Responding to Apple Events / Reference to Responding to Apple Events
Routines for Responding to Apple Events / Requesting User Interaction


AEGetInteractionAllowed

You can use the AEGetInteractionAllowed function to get the current user interaction preferences for responding to an Apple event.

FUNCTION AEGetInteractionAllowed 
                        (VAR level: AEInteractAllowed): OSErr;
level
The current user interaction level, using the data type AEInteractAllowed.
TYPE AEInteractAllowed = (kAEInteractWithSelf,
kAEInteractWithLocal,
kAEInteractWithAll);
DESCRIPTION
The AEGetInteractionAllowed function returns, in the level parameter, a value that indicates the user interaction preferences for responding to an Apple event. The value, set by a previous call to AESetInteractionAllowed, is one of the following flags: kAEInteractWithSelf, kAEInteractWithLocal, or kAEInteractWithAll. The default value of kAEInteractWithLocal is returned if your application has not used AESetInteractionAllowed to set the interaction level explicitly.

The kAEInteractWithSelf flag indicates that the server application may interact with the user in response to an Apple event only when the client application and server application are the same--that is, only when the application is sending the Apple event to itself.

The kAEInteractWithLocal flag indicates that the server application may interact with the user in response to an Apple event only if the client application is on the same computer as the server application. This is the default if your application has not used the AESetInteractionAllowed function to set the interaction level explicitly.

The kAEInteractWithAll flag indicates that the server application may interact with the user in response to an Apple event sent from any client application on any computer.

RESULT CODE
noErr0No error

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996