Livecode Wiki

Specifies the fill pattern used for the background when an object(glossary), or text in an object(glossary), is highlighted.Syntax:

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


set the hilitePattern to 3859

Use the hilitePattern property to specify the background pattern used for the selected text in a field, or the highlighted pattern of a clicked object(glossary), or the pattern of graphic markers.

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 hilitePattern of controls is drawn starting at the control's upper right corner: if the control(keyword) is moved, the pattern does not shift.

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

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

  • The hilitePattern of a button is used for the background of the
 button when it is highlighted. If the button(keyword) is
 a menu, the hilitePattern is used to highlight the
 button(keyword), but not the active menu choice. The hilitePattern
 has no effect if the button(keyword) is a tabbed button. The
 hilitePattern has no effect until the button(keyword) is

If the lookAndFeel is set to

"Appearance Manager", standard and rectangle buttons are drawn by the operating system if the backgroundColor and backgroundPattern of the button(keyword) and all of its owners is empty. In this case, the button's hilitePattern has no effect. Otherwise, the button(keyword) is drawn by LiveCode. If the lookAndFeel is "Appearance Manager", button menus whose menuMode is set to "option" are always drawn by the operating system, and the setting of the button's hilitePattern does not affect them.

  • The hilitePattern of a field determines the background color of
 text selections in the field.

  • The hilitePattern of a scrollbar fills the arrow boxes at the ends
 of the scrollbar when the arrows are clicked. The hilitePattern
 has no effect until the arrows are clicked.

If the object's hilitePattern is set, the pattern is shown instead of the color specified by hiliteColor.

Unlike the hiliteColor property, the hilitePattern is not a global property. Setting the hilitePattern of an object(glossary) to empty causes the hilitePattern of the object's owner to be used for the object(glossary).

See also: button (object),stack (object),control (object),bottomPattern (property),hiliteFill (property),pixels (property),hiliteColor (property),markerLineSize (property),