Livecode Wiki

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

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


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

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

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

If the focusColor is not set for any object(glossary) in the [[object hierarchy]], the system setting is used.

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

 focusColor of each object(glossary) in the stack, card, or
 group that does not have its own focusColor.

  • The focusColor of a button(keyword) is used to outline the
 button(keyword) when it is focused. If the
 button's style is menu, or if the button's
 traversalOn property is false, the focusColor has no effect.

 object(glossary) when it is focused. If the
 object's traversalOn property is false, the focusColor
 has no effect.

 or EPS object 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.

See also: audioClip (object),button (object),control (object),stack (object),videoClip (object),style (property),owner (property),traversalOn (property),showFocusBorder (property),focusColor (property),