Specifies whether a button becomes armed when the mouse pointer moves into it.
# Metadata
Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:
# Syntax
set the autoArm of button to {true | false}
# Examples
set the autoArm of last button to false
set the autoArm of button "Menu Choices" to true
# Description
Use the autoArm property to provide visual feedback to the user about which button the mouse pointer is over. Usually, the autoArm property is used for buttons that are part of stack menus.
If a button's autoArm property is true, it receives keyDown and keyUp messages for keypresses that occur while the mouse is pressed and the pointer is over the button. If the button autoArm is false, it does not receive key messages while being clicked.
# Tags
ui,
# See
- **keyword:** pointer, button - **property:** showHilite, armed, armFill, armedIcon - **message:** mouseDown, keyDown, keyUp - **object:** button - **glossary:** property, stack menu, mouse pointer, message, menu item, cascading menu