mirror of
https://github.com/keymanapp/keyman.git
synced 2026-08-06 17:05:34 +00:00
6c145cb775
Note: build.sh updated to make sure that test:help build action:target doesn't also call test.sh by adding `:_all` meta-target. Note: CI will need a new help-keyman-com.sh build step to deploy web engine help. Fixes: #12347
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
|
|
|
|
```c
|
|
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.
|