colors

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the colors of <object> to <colorsList>
Associationsstack, card, field, button, graphic, scrollbar, player, image
Summary

Specifies all the colors of an object, in shorthand form.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
put the colors of this stack into field "Colors"
put "blue" & return & \
  "#EE98AA" & return & \
  line 5 of the colorNames & return & \
  220,180,200 & return & \
  "yellow" & return & \
  200,200,60 & return & \
  "#334433" & return & \
  "pink" into field "colors"
set the colors of button "mybtn" to field "colors"
set the colors of this stack to the colors of stack "Home"
Values
NameTypeDescription
Value

The colors of an object is a list of color references, one per line. A color reference is any standard color name; or three comma-separated integers between zero and 255, specifying the level of each of red, green, and blue; or an HTML-style color consisting of a hash mark (#) followed by three hexadecimal numbers, one for each of red, green, and blue.

The colors of an image contains as many lines as there are colors used in the image. The colors of all other objects consists of eight lines, some of which may be empty.

RelatedKeyword: colorPalette, line
Property: foregroundColor, backgroundColor, hiliteColor, borderColor, topColor, bottomColor, shadowColor, focusColor, linkColor, linkHiliteColor, owner, patterns, properties
Command: answer color
Function: mouseColor
Glossary: color reference, image, inheritance, object, property
Description

Use the colors property to get all eight basic color properties at once, or to set the colors of one object to be the same as the colors of another object.

For objects other than images, you can set all these colors individually; the colors property simply provides a shorter method of dealing with all of them at once. Each line of the colors corresponds to one of the following color properties :

If you leave a line blank when setting the colors, the color property corresponding to that line is left unchanged.

If the colors property of an object reports a blank line, that color is not set for the individual object, but is inherited from the object's owner. Use the form the effective colors of object to obtain the colors used for the object, whether set for the object or inherited.

If a pattern is set for an object, that pattern is used instead of the corresponding color for that object.

Tagsui