Livecode Wiki
Advertisement

Specifies the color of a three-D object's raised edge.Syntax:

set the topColor of <object> to {empty | <colorName> | <RGBColor>}

Examples:

set the topColor of last button to 32,32,96
set the topColor of this stack to "white"
set the topColor of scrollbar ID 22 to "#339933"

Objects whose threeD property is set to true appear to stick out of or recede into the screen. Use the topColor property to specify the color of the raised edge of the object(glossary).

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

If the object's showBorder property is false, the topColor has no effect.

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

  • The topColor of a stack determines the topColor of each
 object(glossary) in the stack that does not have its own
 topColor. 


  • The topColor of a card determines the color of the border on the
 top and left edges of the card or group, as well as determining
 the topColor of each object(glossary) on the card that does not
 have its own topColor.


  • The topColor of a group determines the color of the border on the
 bottom and right edges of the group, as well as determining the
 topColor of each object(glossary) in the group that does not have
 its own topColor.


 forms a border on the top and left edges of the object(glossary). If
 the object's threeD property is false, the topColor has
 no effect.


  • The topColor of a field(keyword) forms a border on the bottom and
 right edges of the field(keyword) and (if the field(keyword) is a
 scrolling field(keyword)) the top and left edges of the arrow boxes
 at the ends of the scrollbar and the bottom and right edges of the
 scroll area. The field's topColor also determines
 the color of the top and left edges of any text in the
 field(keyword) whose textStyle is set to "threeDBox". If the
 field's threeD property is false, the
 field(keyword) border is not affected.


  • The topColor of a scrollbar forms a border on the top and left
 edges of the arrow boxes at the ends of the scrollbar, and the
 bottom and right edges of the scroll area.


  • The topColor of an audio clip or video clip has no effect.


  • The topColor of an image(keyword) is the fifth color in the
 image's color palette. (To set the color of the
 raised edge of an image's border, set the topColor
 of the card, stack, or group that owns the
 image(keyword).) 


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

See also: image (object),field (object),stack (object),bottomColor (property),shadowColor (property),hiliteColor (property),hiliteBorder (property),borderColor (property),topPattern (property),threeD (property),colors (property),backgroundColor (property),owner (property),topColor (property),textStyle (property),

Advertisement