Updates Geometry settings.
# Metadata
Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:
# Syntax
revCacheGeometry
# Examples
revCacheGeometry
if the rect of me is not savedRect then revCacheGeometry
# Description
Use the revCacheGeometry command to update the Geometry pane's internal settings, after changing the size or position of controls that you have used the Geometry pane to specify behavior for.
The revCacheGeometry command rebuilds the Geometry pane internal settings for the controls on the current card, storing the baseline position that the automatic positioning and scaling uses as a starting point.
The LiveCode development environment automatically executes the revCacheGeometry command when a resizeControl or moveControl message is sent. This means that when you move or resize a control in the development environment, its stored Geometry baseline is normally updated automatically.
Normally, you do not need to use the revCacheGeometry command at all, since LiveCode automatically updates the geometry settings when a control is moved or resized. However, if you move or resize controls manually or in a handler, and the resizeControl or moveControl message is not sent, you may need to use the revCacheGeometry command to update the baseline positions.
To update the settings, use the following statement in a handler or the message box, before changing cards or resizing the window:
revCacheGeometry
>*Important:* The revCacheGeometry command is part of the > Geometry library. To ensure that the command works in a > standalone application, you must include this > LiveCode custom library when you create your > standalone application. In the Inclusions pane of the > Standalone Application Settings window, make sure the "Geometry" > library checkbox is checked.
# Tags
ui,
# See
- **message:** moveControl, openBackground, startup, preOpenStack, openStack, resizeControl, preOpenCard - **command:** lock messages, revUpdateGeometry - **glossary:** LiveCode custom library, application, main stack, handler, development environment, Standalone Application Settings, message, group, standalone application, control, pane, command - **library:** Geometry library, library