spiegel-keyman/web/docs/engine/reference/osk/setRect.md
Marc Durdin 1f82507730 docs(web): deprecate unused and obsolete API endpoints and docs cleanup
Deprecate the following obsolete functions and properties:
* `keyman.helpURL`
* `keyman.util.rgba`
* `keyman.util.toFloat`
* `keyman.util.toNumber`
* `keyman.util.toNzString`

Use correct language for code blocks in Keyman Engine for Web
documentation.

Test-bot: skip
2026-08-12 16:07:22 +02:00

1.4 KiB

title
setRect

Summary

Set absolute position and size of desktop OSK window.

Syntax

keyman.osk.setRect(p);

Parameters

p
Type: Object
An object specifying location and/or user permissions for altering the OSK's display.

Return Value

undefined

Description

The setRect object contains the following members:

left
number optional
Sets the x-coordinate of the OSK's left side.
top
number optional
Sets the y-coordinate of the OSK's top side.
width
number optional
Sets the width of the OSK.
height
number optional
Sets the height of the OSK.
nosize
boolean optional
If set to true, prevents the user from altering the OSK's size. If set to false, allows the user to resize the OSK. If omitted, does not change the existing state.
nomove
boolean optional
If set to true, prevents the user from relocating the OSK manually. If set to false, allows the user to move the OSK. If omitted, does not change the existing state.

The values and states of omitted object members will not be changed.

This differs from setPos() in that it allows resizing the keyboard and controlling the user's ability to move/size the keyboard. Furthermore, when left and top members are included, they override the default position of the keyboard rather than setting the position temporarily.