Installs an event monitor that receives copies of events posted to other applications.
SDK
- macOS 10.6+
Framework
- App
Kit
Declaration
+ (id)addGlobalMonitorForEventsMatchingMask:(NSEvent Mask)mask handler:(void (^)(NSEvent *))block;
Parameters
mask
An event mask specifying which events you wish to monitor. See
NSEvent
for possible values.Mask block
The event handler block object. It is passed the event to monitor. You are unable to change the event, merely observe it.
Return Value
An event handler object.
Discussion
Events are delivered asynchronously to your app and you can only observe the event; you cannot modify or otherwise prevent the event from being delivered to its original target application.
Key-related events may only be monitored if accessibility is enabled or if your application is trusted for accessibility access (see AXIs
).
Note that your handler will not be called for events that are sent to your own application.
Special Considerations
In OS X v 10.6, event monitors are only able to monitor the following event types: