Document how to get a human-readable string from an InputEventKey

This commit is contained in:
Hugo Locurcio 2020-01-25 20:09:04 +01:00
parent a61f5a7520
commit 7a0c37c3f5
No known key found for this signature in database
GPG key ID: 39E8F8BE30B0A49C
2 changed files with 5 additions and 2 deletions

View file

@ -15,6 +15,7 @@
</return> </return>
<description> <description>
Returns the scancode combined with modifier keys such as [code]Shift[/code] or [code]Alt[/code]. See also [InputEventWithModifiers]. Returns the scancode combined with modifier keys such as [code]Shift[/code] or [code]Alt[/code]. See also [InputEventWithModifiers].
To get a human-readable representation of the [InputEventKey] with modifiers, use [code]OS.get_scancode_string(event.get_scancode_with_modifiers())[/code] where [code]event[/code] is the [InputEventKey].
</description> </description>
</method> </method>
</methods> </methods>
@ -26,10 +27,11 @@
If [code]true[/code], the key's state is pressed. If [code]false[/code], the key's state is released. If [code]true[/code], the key's state is pressed. If [code]false[/code], the key's state is released.
</member> </member>
<member name="scancode" type="int" setter="set_scancode" getter="get_scancode" default="0"> <member name="scancode" type="int" setter="set_scancode" getter="get_scancode" default="0">
Key scancode, one of the [enum KeyList] constants. The key scancode, which corresponds to one of the [enum KeyList] constants.
To get a human-readable representation of the [InputEventKey], use [code]OS.get_scancode_string(event.scancode)[/code] where [code]event[/code] is the [InputEventKey].
</member> </member>
<member name="unicode" type="int" setter="set_unicode" getter="get_unicode" default="0"> <member name="unicode" type="int" setter="set_unicode" getter="get_unicode" default="0">
Key Unicode identifier when relevant. Unicode identifiers for the composite characters and complex scripts may not be available unless IME input mode is active. See [method OS.set_ime_active] for more information. The key Unicode identifier (when relevant). Unicode identifiers for the composite characters and complex scripts may not be available unless IME input mode is active. See [method OS.set_ime_active] for more information.
</member> </member>
</members> </members>
<constants> <constants>

View file

@ -333,6 +333,7 @@
</argument> </argument>
<description> <description>
Returns the given scancode as a string (e.g. Return values: [code]"Escape"[/code], [code]"Shift+Escape"[/code]). Returns the given scancode as a string (e.g. Return values: [code]"Escape"[/code], [code]"Shift+Escape"[/code]).
See also [member InputEventKey.scancode] and [method InputEventKey.get_scancode_with_modifiers].
</description> </description>
</method> </method>
<method name="get_screen_count" qualifiers="const"> <method name="get_screen_count" qualifiers="const">