TSdlPenProximityEvent
Pressure-sensitive pen proximity event structure (Event.PenProximity.* )
When a pen becomes visible to the system (it is close enough to a tablet, etc), SDL will send an TSdlEventKind.PenProximityIn event with the new pen's ID. This ID is valid until the pen leaves proximity again (has been removed from the tablet's area, the tablet has been unplugged, etc). If the same pen reenters proximity again, it will be given a new ID.
Note that "proximity" means "close enough for the tablet to know the tool is there." The pen touching and lifting off from the tablet while not leaving the area are handled by TSdlEventKind.PenDown and TSdlEventKind.PenUp.
Definition
Unit: Neslib.Sdl3.Events
Properties
Name | Description |
---|---|
Kind | Event kind (TSdlEventKind.PenProximityIn/Out) |
PenID | The pen instance id |
Timestamp | In nanoseconds, populated using SdlGetTicksNS |
Window | The window with pen focus, if any |
WindowID | The ID of the window with pen focus, if any |
Property Descriptions
Kind
Event kind (TSdlEventKind.PenProximityIn/Out)
property Kind: TSdlEventKind read GetKind
Type: TSdlEventKind
PenID
The pen instance id
property PenID: TSdlPenID read FHandle.which
Type: TSdlPenID
Timestamp
In nanoseconds, populated using SdlGetTicksNS
property Timestamp: UInt64 read FHandle.timestamp
Type: UInt64
Window
The window with pen focus, if any
property Window: TSdlWindow read GetWindow
Type: TSdlWindow
WindowID
The ID of the window with pen focus, if any
property WindowID: TSdlWindowID read FHandle.windowID
Type: TSdlWindowID