focusColor

Specifies the color of the outline around the active control or the field with the insertion point.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

set the focusColor of object to {empty | colorName | RGBColor}

# Examples

set the focusColor of me to "black"

set the focusColor of button "Help" to 128,128,255

# Description

Use the focusColor property to specify the outline color of an object when it's active.

Setting the focusColor of an object to empty allows the focusColor of the object owner to show through. Use the effective keyword to find out what color is used for the object, even if its own focusColor is empty.

If the focusColor is not set for any object in the object hierarchy, the system setting is used.

The setting of the focusColor property has different effects, depending on the object type:

* The focusColor of a stack, card, or group determines the focusColor of each object in the stack, card, or group that does not have its own focusColor.

* The focusColor of a button is used to outline the button when it is focus. If the button style is menu, or if the button's traversalOn property is false, the focusColor has no effect.

* The focusColor of a field or scrollbar is used to outline the object when it is focus. If the object traversalOn property is false, the focusColor has no effect.

* The focusColor of an image is the eighth color in the image's color palette.

If an object's focusPattern is set, the pattern is shown instead of the color specified by the focusColor.

The focusColor property has no effect on controls whose showFocusBorder property is set to false.

If the lookAndFeel is set to "Macintosh" or "Appearance Manager", the focusColor affects only fields.

# Tags

# See