|Type||Topic||Plugin||Version||macOS||Windows||Linux||Console & Web||iOS|
|class||CoreGraphics Events||MBS MacCF Plugin||17.4||Yes||No||No||Yes, macOS only||No|
Taps may be placed at the point where HIDSystem events enter the server, at the point where HIDSystem and remote control events enter a session, at the point where events have been annotated to flow to a specific application, or at the point where events are delivered to the application. Taps may be inserted at a specified point at the head of pre-existing filters, or appended after any pre-existing filters.
Taps may be passive event listeners, or active filters. An active filter may pass an event through unmodified, modify an event, or discard an event. When a tap is registered, it identifies the set of events to be observed with a mask, and indicates if it is a passive or active event filter. Multiple event type bitmasks may be ORed together.
Taps may only be placed at kCGHIDEventTap by a process running as the root user. An exception is raised for other users.
Taps placed at kCGHIDEventTap, kCGSessionEventTap, kCGAnnotatedSessionEventTap, or on a specific process may only receive key up and down events if access for assistive devices is enabled (Preferences Accessibility panel, Keyboard view) or the caller is enabled for assistive device access, as by AXMakeProcessTrusted. If the tap is not permitted to monitor these events when the tap is created, then the appropriate bits in the mask are cleared. If that results in an empty mask, then an exception is raised.
For MacOS 10.15 using CGEventTap to track other applications may result in a dialog asking for permissions. This may not happen if you track your own process' events.
- event GotEvent(Proxy as Ptr, type as Integer, e as CGEventMBS) as CGEventMBS
- property Enabled as Boolean
- method Constructor(tapLocation as Integer, Place as Integer, Options as Integer, EventMask as Integer, PID as Integer = -1)
- shared method available as boolean
- 24 constants
At the point where events have been annotated to flow to a specific application, or at the point where events are delivered to the application.
When HIDSystem events enter the server.
At the point where HIDSystem and remote control events enter a session.
Key flags changed, e.g. modifier keys pressed.
Listen for all events.
left mouse-down event
left mouse-dragged event
left mouse-up event
other mouse-down event
other mouse-dragged event
other mouse-up event
right mouse-down event
right mouse-dragged event
right mouse-up event
Scroll Wheel event.
Tablet pointer event.
Tablet Proximity event.
This class has no sub classes.
Some examples which use this class:
The items on this page are in the following plugins: MBS MacCF Plugin.
MBS Xojo blog