mirror of
https://github.com/keymanapp/keyman.git
synced 2026-08-21 07:47:40 +00:00
1f82507730
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
55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
---
|
|
title: setRect
|
|
---
|
|
|
|
## Summary
|
|
|
|
Set absolute position and size of desktop OSK window.
|
|
|
|
## Syntax
|
|
|
|
```js
|
|
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()`](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.
|