Interface WlSeatEvents
- All Known Subinterfaces:
WlSeatEventsV2,WlSeatEventsV3,WlSeatEventsV4,WlSeatEventsV5,WlSeatEventsV6,WlSeatEventsV7,WlSeatEventsV8,WlSeatEventsV9
A seat is a group of keyboards, pointer and touch devices. This object is published as a global during start up, or when such a device is hot plugged. A seat typically has a pointer and maintains a keyboard focus and a pointer focus.
-
Field Summary
Fields -
Method Summary
Modifier and TypeMethodDescriptionvoidcapabilities(WlSeatProxy emitter, int capabilities) seat capabilities changed
-
Field Details
-
VERSION
static final int VERSION- See Also:
-
-
Method Details
-
capabilities
seat capabilities changedThis is emitted whenever a seat gains or loses the pointer, keyboard or touch capabilities. The argument is a capability enum containing the complete set of capabilities this seat has.
When the pointer capability is added, a client may create a wl_pointer object using the wl_seat.get_pointer request. This object will receive pointer events until the capability is removed in the future.
When the pointer capability is removed, a client should destroy the wl_pointer objects associated with the seat where the capability was removed, using the wl_pointer.release request. No further pointer events will be received on these objects.
In some compositors, if a seat regains the pointer capability and a client has a previously obtained wl_pointer object of version 4 or less, that object may start sending pointer events again. This behavior is considered a misinterpretation of the intended behavior and must not be relied upon by the client. wl_pointer objects of version 5 or later must not send events if created before the most recent event notifying the client of an added pointer capability.
The above behavior also applies to wl_keyboard and wl_touch with the keyboard and touch capabilities, respectively.
- Parameters:
emitter- The protocol object that emitted the event.capabilities- capabilities of the seat
-