Enum Event 

#[non_exhaustive]
pub enum Event {
    Enter {
        surface: WlSurface,
    },
    Leave {
        surface: WlSurface,
    },
    PreeditString {
        text: Option<String>,
        cursor_begin: i32,
        cursor_end: i32,
    },
    CommitString {
        text: Option<String>,
    },
    DeleteSurroundingText {
        before_length: u32,
        after_length: u32,
    },
    Done {
        serial: u32,
    },
    Action {
        action: WEnum<Action>,
        serial: u32,
    },
    Language {
        language: String,
    },
    PreeditHint {
        start: u32,
        end: u32,
        hint: WEnum<PreeditHint>,
    },
}

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Enter

enter event

Notification that this seat’s text-input focus is on a certain surface.

If client has created multiple text input objects, compositor must send this event to all of them.

When the seat has the keyboard capability the text-input focus follows the keyboard focus. This event sets the current surface for the text-input object.

Fields

surface: WlSurface

Leave

leave event

Notification that this seat’s text-input focus is no longer on a certain surface. The client should reset any preedit string previously set.

The leave notification clears the current surface. It is sent before the enter notification for the new focus. After leave event, compositor must ignore requests from any text input instances until next enter event.

When the seat has the keyboard capability the text-input focus follows the keyboard focus.

Fields

surface: WlSurface

PreeditString

pre-edit

Notify when a new composing text (pre-edit) should be set at the current cursor position. Any previously set composing text must be removed. Any previously existing selected text must be removed.

The argument text contains the pre-edit string buffer.

The parameters cursor_begin and cursor_end are counted in bytes relative to the beginning of the submitted text buffer. Cursor should be hidden when both are equal to -1.

They could be represented by the client as a line if both values are the same, or as a text highlight otherwise.

Values set with this event are double-buffered. They must be applied and reset to initial on the next zwp_text_input_v3.done event.

The initial value of text is an empty string, and cursor_begin, cursor_end and cursor_hidden are all 0.

Fields

text: Option<String>

cursor_begin: i32

cursor_end: i32

CommitString

text commit

Notify when text should be inserted into the editor widget. The text to commit could be either just a single character after a key press or the result of some composing (pre-edit).

Values set with this event are double-buffered. They must be applied and reset to initial on the next zwp_text_input_v3.done event.

The initial value of text is an empty string.

Fields

text: Option<String>

DeleteSurroundingText

delete surrounding text

Notify when the text around the current cursor position should be deleted.

Before_length and after_length are the number of bytes before and after the current cursor index (excluding the selection) to delete.

If a preedit text is present, in effect before_length is counted from the beginning of it, and after_length from its end (see done event sequence).

Values set with this event are double-buffered. They must be applied and reset to initial on the next zwp_text_input_v3.done event.

The initial values of both before_length and after_length are 0.

Fields

before_length: u32

length of text before current cursor position

after_length: u32

length of text after current cursor position

Done

apply changes

Instruct the application to apply changes to state requested by the preedit_string, commit_string delete_surrounding_text, and action events.

The state relating to these events is double-buffered, and each one modifies the pending state. This event replaces the current state with the pending state.

The application must proceed by evaluating the changes in the following order:

1. Replace existing preedit string with the cursor.
2. Delete requested surrounding text.
3. Insert commit string with the cursor at its end.
4. Calculate surrounding text to send.
5. Insert new preedit text in cursor position.
6. Place cursor inside preedit text.
7. Perform the requested action.

The serial number reflects the last state of the zwp_text_input_v3 object known to the compositor. The value of the serial argument must be equal to the number of commit requests already issued on that object.

When the client receives a done event with a serial different than the number of past commit requests, it must proceed with evaluating and applying the changes as normal, except it should not change the current state of the zwp_text_input_v3 object. All pending state requests (set_surrounding_text, set_content_type and set_cursor_rectangle) on the zwp_text_input_v3 object should be sent and committed after receiving a zwp_text_input_v3.done event with a matching serial.

Fields

serial: u32

Action

action performed

An action was performed on this text input.

Values set with this event are double-buffered. They must be applied and reset to initial on the next zwp_text_input_v3.done event.

The initial value of action is none.

Only available since version 2 of the interface

Fields

action: WEnum<Action>

action performed

serial: u32

serial number of the action event

Language

notify of language selection

Notify the application of language used by the input method.

This event will be sent on creation if known and for all subsequent changes.

The language should be specified as an IETF BCP 47 tag. Setting an empty string will reset any known language back to the default unknown state.

Only available since version 2 of the interface

Fields

language: String

new language set by IME

PreeditHint

pre-edit

Notify of contextual hints for the pre-edit string. This event is always sent together with a zwp_text_input_v3.preedit_string event.

The parameters start and end are counted in bytes relative to the beginning of the text buffer submitted through zwp_text_input_v3.preedit_string, and represent the substring in the pre-edit text affected by the hint.

Multiple events may be submitted if the preedit string has different sections. The extent of hints may overlap. The parts of the preedit string that are not covered by any zwp_text_input_v3.preedit_hint event, the text will be considered unhinted. This is also the case if no preedit_hint event is sent.

Clients should provide recognizable visuals to these hints. if they are unable to comply with this requisition, it may be preferable for them keep the preedit_shown content hint disabled.

Values set with this event are double-buffered. They must be applied and reset on the next zwp_text_input_v3.done event.

Only available since version 2 of the interface

Fields

start: u32

starting point of the affected substring

end: u32

end point of the affected substring

hint: WEnum<PreeditHint>

hint to apply

Implementations

impl Event

pub fn opcode(&self) -> u16

Get the opcode number of this message

Trait Implementations

impl Debug for Event

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.