doc: add some more text protocol documentation

Signed-off-by: Jan Arne Petersen <jpetersen@openismus.com>
Jan Arne Petersen 12 years ago committed by Kristian Høgsberg
parent a75a789fc1
commit 8746ba0d29
  1. 26
      protocol/text.xml

@ -42,7 +42,7 @@
Sets the plain surrounding text around the input position. Cursor is the Sets the plain surrounding text around the input position. Cursor is the
byte index within the surrounding text. Anchor is the byte index of the byte index within the surrounding text. Anchor is the byte index of the
selection anchor within the surrounding text. If there is no selected selection anchor within the surrounding text. If there is no selected
text anchor is the same as cursor. text anchor is the same as cursor.
</description> </description>
<arg name="text" type="string"/> <arg name="text" type="string"/>
<arg name="cursor" type="uint"/> <arg name="cursor" type="uint"/>
@ -145,6 +145,8 @@
to commit could be either just a single character after a key press to commit could be either just a single character after a key press
or the result of some composing (pre-edit). It also sets the new or the result of some composing (pre-edit). It also sets the new
cursor position (as byte index) relative to the inserted text. cursor position (as byte index) relative to the inserted text.
Any previously set composing text should be removed.
</description> </description>
<arg name="serial" type="uint"/> <arg name="serial" type="uint"/>
<arg name="text" type="string"/> <arg name="text" type="string"/>
@ -154,8 +156,10 @@
<description summary="pre-edit"> <description summary="pre-edit">
Notify when a new composing text (pre-edit) should be set around the Notify when a new composing text (pre-edit) should be set around the
current cursor position. Any previously set composing text should current cursor position. Any previously set composing text should
be removed. It also sets the cursor position (as byte index) relative be removed.
to the start of the composing text.
The commit text can be used to replace the preedit text on reset
(for example on unfocus).
</description> </description>
<arg name="serial" type="uint"/> <arg name="serial" type="uint"/>
<arg name="text" type="string"/> <arg name="text" type="string"/>
@ -181,6 +185,15 @@
<entry name="incorrect" value="7"/> <entry name="incorrect" value="7"/>
</enum> </enum>
<event name="preedit_styling"> <event name="preedit_styling">
<description summary="pre-edit styling">
Sets styling information on composing text. The style is applied for
length (in bytes) characters from index relative to the beginning of
the composing text (as byte index). Multiple styles can be applied
to a composing text.
This event should be handled as part of a following preedit_string
event.
</description>
<arg name="serial" type="uint"/> <arg name="serial" type="uint"/>
<arg name="index" type="uint"/> <arg name="index" type="uint"/>
<arg name="length" type="uint"/> <arg name="length" type="uint"/>
@ -190,6 +203,9 @@
<description summary="pre-edit cursor"> <description summary="pre-edit cursor">
Sets the cursor position inside the composing text (as byte index) Sets the cursor position inside the composing text (as byte index)
relative to the start of the composing text. relative to the start of the composing text.
This event should be handled as part of a following preedit_string
event.
</description> </description>
<arg name="serial" type="uint"/> <arg name="serial" type="uint"/>
<arg name="index" type="int"/> <arg name="index" type="int"/>
@ -208,8 +224,8 @@
for normal text input operations, which should be done with for normal text input operations, which should be done with
commit_string, delete_surrounfing_text, etc. The key event follows commit_string, delete_surrounfing_text, etc. The key event follows
the wl_keyboard key event convention. State is a XKB keysym, state a the wl_keyboard key event convention. State is a XKB keysym, state a
wl_keyboard key_state. Modifiers are a mask for effective modifiers wl_keyboard key_state. Modifiers are a mask for effective modifiers
(where the modfier indices are set by the modifiers_map event) (where the modfier indices are set by the modifiers_map event)
</description> </description>
<arg name="serial" type="uint"/> <arg name="serial" type="uint"/>
<arg name="time" type="uint"/> <arg name="time" type="uint"/>

Loading…
Cancel
Save