Pārlūkot izejas kodu

Merge pull request #93562 from Calinou/doc-input-echo-keyword

Add "repeat" keyword alias for InputEvent "echo" in the class reference
Rémi Verschelde 1 gadu atpakaļ
vecāks
revīzija
30ae23c086
2 mainītis faili ar 6 papildinājumiem un 4 dzēšanām
  1. 3 2
      doc/classes/InputEvent.xml
  2. 3 2
      doc/classes/InputEventKey.xml

+ 3 - 2
doc/classes/InputEvent.xml

@@ -77,10 +77,11 @@
 				Returns [code]true[/code] if this input event has been canceled.
 			</description>
 		</method>
-		<method name="is_echo" qualifiers="const">
+		<method name="is_echo" qualifiers="const" keywords="is_repeat">
 			<return type="bool" />
 			<description>
-				Returns [code]true[/code] if this input event is an echo event (only for events of type [InputEventKey]). Any other event type returns [code]false[/code].
+				Returns [code]true[/code] if this input event is an echo event (only for events of type [InputEventKey]). An echo event is a repeated key event sent when the user is holding down the key. Any other event type returns [code]false[/code].
+				[b]Note:[/b] The rate at which echo events are sent is typically around 20 events per second (after holding down the key for roughly half a second). However, the key repeat delay/speed can be changed by the user or disabled entirely in the operating system settings. To ensure your project works correctly on all configurations, do not assume the user has a specific key repeat configuration in your project's behavior.
 			</description>
 		</method>
 		<method name="is_match" qualifiers="const">

+ 3 - 2
doc/classes/InputEventKey.xml

@@ -59,8 +59,9 @@
 		</method>
 	</methods>
 	<members>
-		<member name="echo" type="bool" setter="set_echo" getter="is_echo" default="false">
-			If [code]true[/code], the key was already pressed before this event. It means the user is holding the key down.
+		<member name="echo" type="bool" setter="set_echo" getter="is_echo" default="false" keywords="repeat">
+			If [code]true[/code], the key was already pressed before this event. An echo event is a repeated key event sent when the user is holding down the key.
+			[b]Note:[/b] The rate at which echo events are sent is typically around 20 events per second (after holding down the key for roughly half a second). However, the key repeat delay/speed can be changed by the user or disabled entirely in the operating system settings. To ensure your project works correctly on all configurations, do not assume the user has a specific key repeat configuration in your project's behavior.
 		</member>
 		<member name="key_label" type="int" setter="set_key_label" getter="get_key_label" enum="Key" default="0">
 			Represents the localized label printed on the key in the current keyboard layout, which corresponds to one of the [enum Key] constants or any valid Unicode character.