Keyboard Support

Contact and Search

Keyman.com Homepage

Header bottom

Keyman.com

Other versions
Version 17.0 (current version)Version 16.0Version 15.0Version 14.0Version 13.0Version 12.0Version 11.0Version 10.0Version 2.0

On this page

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.