autoArm

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.

A button whose autoArm property is set to true does not receive mouseDown messages.

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