Livecode Wiki
Advertisement

Specifies the pattern used for object(glossary) text and borders.Syntax:

set the foregroundPattern of [<chunk> of] <field> to {<patternNumber> | <imageID> | empty}

Examples:

set the foregroundPattern of me to 1034
set the textPattern of line 2 of field "Cards" to 111

Use the foregroundPattern property to change the pattern used for text or the pattern that fills an object(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 foregroundPattern 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 foregroundPattern of an object(glossary) to empty allows the foregroundPattern of the object's owner to show through. Use the effective keyword to find out what pattern is used for the object(glossary), even if its own foregroundPattern is empty.

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

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


  • On Unix systems, the foregroundPattern of a button(keyword) is
 used for the text of the button(keyword). If the
 button's showName property is false, the
 foregroundPattern has no effect.


  • On Unix systems, the foregroundPattern of a field(keyword)
 determines the color of the field's text. If you set
 the foregroundColor of a chunk of a field(keyword), only that
 chunk is affected. The foregroundPattern also determines the color
 of the blinking insertion point when it is in the field(keyword).


  • On Unix systems, the foregroundPattern of a scrollbar(keyword)
 determines the pattern of the text used to show the value of the
 scrollbar's current position. If the
 scrollbar's showValue property is false, the
 foregroundPattern has no effect.


  • The foregroundPattern of a graphic(keyword) determines the pattern
 used for the graphic's outline. (The borderPattern
 determines the pattern used for the graphic's
 border, which is outside the outline.)


  • The foregroundPattern of a player, image, audio clip, [[video
 clip]], or EPS object has no effect. If an object's
 foregroundPattern is set, the pattern is shown instead of the color
 specified by foregroundColor.


On Mac OS and Windows systems, the

foregroundPattern applies only to object(glossary) borders, not to text; text cannot be drawn with a pattern, only with a color.

See also: control (object),button (object),scrollbar (object),stack (object),field (object),graphic (object),borderPattern (property),foregroundColor (property),pixels (property),bottomPattern (property),width (property),height (property),backgroundPattern (property),dashes (property),showName (property),penPattern (property),owner (property),showValue (property),

Advertisement