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.