Livecode Wiki

Specifies the pattern used for an object's outline when it has the insertion point or is active (focused)(glossary).Syntax:

set the focusPattern of <object> to {<patternNumber> | <imageID> | empty}


set the focusPattern of this stack to 2215

Use the focusPattern property to specify the pattern used for the outline around an active (focused) control(glossary).

Pattern images can be color or black-and-white.

To be used as a pattern on Mac OS
systems, an image must be 128x128 pixels or less, and both its

height and width must be a power of 2. To be used on Windows and Unix systems, height and width must be divisible by 8. To be used as a fully cross-platform pattern, both an image's dimensions should be one of 8, 16, 32, 64, or 128.

The focusPattern of controls is drawn starting at the control's upper right corner: if the control(keyword) is moved, the pattern does not shift.

Setting the focusPattern of an object(glossary) to empty allows the focusPattern 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 focusPattern is empty.

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

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

  • The focusPattern 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 focusPattern has no effect.

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

 videoClip, or EPS object has no effect.

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

The focusPattern property has no effect if the lookAndFeel property is set to Macintosha/.

See also: videoClip (object),button (object),control (object),stack (object),audioClip (object),pixels (property),owner (property),height (property),style (property),width (property),focusColor (property),lookAndFeel (property),traversalOn (property),