Type Method

addGlobalMonitorForEventsMatchingMask:handler:

Installs an event monitor that receives copies of events posted to other applications.

Declaration

+ (id)addGlobalMonitorForEventsMatchingMask:(NSEventMask)mask handler:(void (^)(NSEvent *))block;

Parameters

mask

An event mask specifying which events you wish to monitor. See NSEventMask for possible values.

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 AXIsProcessTrusted).

Note that your handler will not be called for events that are sent to your own application.

Special Considerations

See Also

Monitoring Application Events

+ addLocalMonitorForEventsMatchingMask:handler:

Installs an event monitor that receives copies of events posted to this application before they are dispatched.

+ removeMonitor:

Remove the specified event monitor.