Specifies the color of an object border.
# Metadata
Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:
# Syntax
set the borderColor of object to {empty | colorName | RGBColor}
# Params
- colorName : Any standard color name. - RGBColor : Consists of 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.
# Examples
set the borderColor of field "Alert" to "red"
set the borderColor of last button to "#000000"
set the borderColor of scrollbar ID 1010 to "128,128,128"
set the borderColor of line 1 of field 1 to "255,0,0"
# Description
Use the borderColor property to specify the border color of an object or paragraph of text in a field.
By default, the borderColor for all objects is empty.
Setting the borderColor of an object to empty allows the borderColor of the object owner to show through. Use the effective keyword to find out what color is used for the object, even if its own borderColor is empty.
If the object's showBorder property is false, the borderColor has no effect. If the object threeD property is true, the topColor and bottomColor are used to draw the border, rather than the borderColor.
The setting of the borderColor property has different effects, depending on the object type:
* The borderColor of a stack determines the borderColor of each object in the stack that does not have its own borderColor.
* The borderColor of a card or group determines the color of the border around the card or group, as well as determining the borderColor of each object in the card or group that does not have its own borderColor.
* The borderColor of a button determines the color of the border around the button. If the button style is "checkbox" or "radioButton", the borderColor has no effect. If the button is a button menu, the borderColor has no effect unless the button menuMode property is set to "comboBox" or "popup". If the button threeD property is set to true, the borderColor has no effect regardless of the button style.
* The borderColor of a field determines the color of the border around a scrolling field scrollbar, the color of the grid lines if the field hGrid or vGrid property is true, and the color of the outline around any text in the field whose textStyle is set to "box".
* The borderColor of a scrollbar is the color of the border surrounding the scrollbar.
* The borderColor of a graphic is used to fill the marker shapes at the graphic vertex, if the graphic style isorand its markerDrawn is true. It is also used to draw a border around it if the graphic showBorder and threeD properties are both set to true.
* The borderColor of an audio clip or video clip has no effect.
* The borderColor of a player or EPS is the color of the border around the object. If the object threeD property is set to true, the borderColor has no effect.
>*Tip:* To set the color of an image border, set the > borderColor of the card, stack, or group that owner the > image.
If an object's borderPattern is set, the pattern is shown instead of the color specified by borderColor.
# Tags
ui,
# See
- **keyword:** effective, box, field, button, player, graphic, scrollbar, card, image - **property:** bottomColor, borderPattern, textStyle, borderColor, showBorder, borderPixel, hGrid, penBack, vGrid, hiliteColor, markerFilled, style, threeD, menuMode, owner, topColor, selectionHandleColor - **command:** group - **object:** button, image, field, stack, graphic - **glossary:** object, property, EPS, audio clip, owner, vertex, object type, keyword, button menu, video clip