Difference between revisions of "love.keyboard.setTextInput"

m
m
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
 
{{newin|[[0.9.0]]|090|type=function}}
 
{{newin|[[0.9.0]]|090|type=function}}
 
Enables or disables [[love.textinput|text input]] events. It is enabled by default on Windows, Mac, and Linux, and disabled by default on iOS and Android.
 
Enables or disables [[love.textinput|text input]] events. It is enabled by default on Windows, Mac, and Linux, and disabled by default on iOS and Android.
 +
 +
On touch devices, this shows the system's native on-screen keyboard when it's enabled.
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
Line 8: Line 10:
 
=== Arguments ===
 
=== Arguments ===
 
{{param|boolean|enable|Whether text input events should be enabled.}}
 
{{param|boolean|enable|Whether text input events should be enabled.}}
 +
=== Returns ===
 +
Nothing.
 +
 +
== Function ==
 +
{{newin|[[0.10.0]]|0100|type=variant}}
 +
On iOS and Android this variant tells the OS that the specified rectangle is where text will show up in the game, which prevents the system on-screen keyboard from covering the text.
 +
=== Synopsis ===
 +
<source lang="lua">
 +
love.keyboard.setTextInput( enable, x, y, w, h )
 +
</source>
 +
=== Arguments ===
 +
{{param|boolean|enable|Whether text input events should be enabled.}}
 +
{{param|number|x|Text rectangle x position.}}
 +
{{param|number|y|Text rectangle y position.}}
 +
{{param|number|w|Text rectangle width.}}
 +
{{param|number|h|Text rectangle height.}}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.

Latest revision as of 00:18, 30 July 2017

Available since LÖVE 0.9.0
This function is not supported in earlier versions.

Enables or disables text input events. It is enabled by default on Windows, Mac, and Linux, and disabled by default on iOS and Android.

On touch devices, this shows the system's native on-screen keyboard when it's enabled.

Function

Synopsis

love.keyboard.setTextInput( enable )

Arguments

boolean enable
Whether text input events should be enabled.

Returns

Nothing.

Function

Available since LÖVE 0.10.0
This variant is not supported in earlier versions.

On iOS and Android this variant tells the OS that the specified rectangle is where text will show up in the game, which prevents the system on-screen keyboard from covering the text.

Synopsis

love.keyboard.setTextInput( enable, x, y, w, h )

Arguments

boolean enable
Whether text input events should be enabled.
number x
Text rectangle x position.
number y
Text rectangle y position.
number w
Text rectangle width.
number h
Text rectangle height.

Returns

Nothing.

See Also

Other Languages