主题
PointerEvent 继承自: Event[EventControlType]
Low-level pointer payload with detailed device metrics.
属性
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
kind | PointerDeviceType | metadata={'data_field': 'k'} | The kind of input device for which the event was generated. |
local_position | Offset | metadata={'data_field': 'l'} | The position transformed into the event receiver's local coordinate system according to transform. |
global_position | Offset | metadata={'data_field': 'g'} | Coordinate of the position of the pointer, in logical pixels in the global coordinate space. |
timestamp | Duration | metadata={'data_field': 'ts'} | Time of event dispatch, relative to an arbitrary timeline. |
device | float | metadata={'data_field': 'dev'} | Unique identifier for the pointing device, reused across interactions. |
pressure | float | metadata={'data_field': 'ps'} | The pressure of the touch. This value is a number ranging from 0.0, indicating a touch with no discernible pressure, to 1.0, indicating a touch with "normal" pressure, and possibly beyond, indicating a stronger touch. For devices that do not detect pressure (e.g. mice), returns 1.0. |
pressure_min | float | metadata={'data_field': 'pMin'} | The minimum value that pressure can return for this pointer. For devices that do not detect pressure (e.g. mice), returns 1.0. This will always be a number less than or equal to 1.0. |
pressure_max | float | metadata={'data_field': 'pMax'} | The maximum value that pressure can return for this pointer. For devices that do not detect pressure (e.g. mice), returns 1.0. This will always be a greater than or equal to 1.0. |
distance | float | metadata={'data_field': 'dist'} | The distance of the detected object from the input surface. For instance, this value could be the distance of a stylus or finger from a touch screen, in arbitrary units on an arbitrary (not necessarily linear) scale. If the pointer is down, this is 0.0 by definition. |
distance_max | float | metadata={'data_field': 'distMax'} | The maximum value that distance can return for this pointer. If this input device cannot detect "hover touch" input events, then this will be 0.0. |
size | float | metadata={'data_field': 'size'} | The area of the screen being pressed. This value is scaled to a range between 0 and 1. It can be used to determine fat touch events. This value is only set on Android and is a device specific approximation within the range of detectable values. So, for example, the value of 0.1 could mean a touch with the tip of the finger, 0.2 a touch with full finger, and 0.3 the full palm. |
radius_major | float | metadata={'data_field': 'rMj'} | The radius of the contact ellipse along the major axis, in logical pixels. |
radius_minor | float | metadata={'data_field': 'rMn'} | The radius of the contact ellipse along the minor axis, in logical pixels. |
radius_min | float | metadata={'data_field': 'rMin'} | The minimum value that could be reported for radius_major and radius_minor for this pointer, in logical pixels. |
radius_max | float | metadata={'data_field': 'rMax'} | The maximum value that could be reported for radius_major and radius_minor for this pointer, in logical pixels. |
orientation | float | metadata={'data_field': 'or'} | The orientation angle of the detected object, in radians. |
tilt | float | metadata={'data_field': 'tilt'} | The tilt angle of the detected object, in radians. |
local_delta | Optional[Offset] | None | The delta of the pointer's position since the event start, in logical pixels, within the local coordinate space. |
global_delta | Optional[Offset] | None | The delta of the pointer's position since the event start, in logical pixels, within the global coordinate space. |