Skip to content

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

type TSdlPenProximityEvent = record ... end;

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