Livecode Wiki

Specifies the pattern of an object's drop shadow.Syntax:

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


set the shadowPattern of next card to empty
set the shadowPattern of last button to 409

Use the shadowPattern property to specify the drop shadow pattern of a field or button or the background pattern of a scrollbar.

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

Setting the shadowPattern of an object to empty allows the shadowPattern of the object's owner to show through.

Use the effective keyword to find out what color is used for the object, even if its own shadowPattern is empty.

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

  • The shadowPattern of a stack, card, or group determines the shadowPattern of each object in the stack, card, or group that does not have its own shadowPattern.
  • The shadowPattern of a button is used for the button's drop shadow. If the button's style is menu (unless the menuMode is tabbed), the shadowPattern has no effect. If the button is a tabbed button, the shadowPattern is always used for the inactive tabs; otherwise, if the button's shadow property is false, the shadowPattern has no effect.
  • The shadowPattern of a field determines the pattern used for the field's drop shadow. If the field's shadow property is false, the shadowPattern has no effect.
  • The shadowPattern of a scrollbar determines the background pattern of the scrollbar.

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

See also: button (object), field (object), stack (object), control (object), pixels (property), backgroundPattern (property), height (property), style (property), shadow (property), owner (property), borderPattern (property), width (property), shadowColor (property), bottomPattern (property)