<div class="meta" robots="noindex">

</div>

Method

# FrameColor

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

<div class="warning">

<div class="title">

Warning

</div>

This item was deprecated in version 2019r2. Please use `Color.FrameColor<color.framecolor>` as a replacement.

</div>

## Description

The system control color.

## Usage

*result* = **FrameColor**

| Part   | Type                           | Description                                                                             |
|--------|--------------------------------|-----------------------------------------------------------------------------------------|
| result | `Color</api/data_types/color>` | The color used for drawing the outline of a `RectControl</api/deprecated/rectcontrol>`. |

## Notes

This value is useful when you are using `Canvas</api/deprecated/canvas>` controls to create custom controls. When drawing objects, use this color for the object's frame. `ListBoxes</api/deprecated/listbox>`, for example, use this color to draw the dark frame around the `ListBox</api/deprecated/listbox>`.

This value can be changed by the user or when the system switches between light and dark modes, so you should use this method in your Paint Event handler rather than storing the value.

## Sample code

This code uses the system <span class="title-ref">FrameColor</span> to draw the bottom and right of this object. The code is in the `Paint<canvas.paint>` event of the `Canvas</api/deprecated/canvas>`.

``` xojo
Const White = &cffffff

g.ForeColor = White

g.DrawLine(1, 1, g.Width, 1)
g.DrawLine(1, g.Height - 1, 1, 1)
g.ForeColor = FrameColor
g.DrawLine(g.Width - 1, 2, g.Width - 1, g.Height)
g.DrawLine(1, g.Height - 1, g.Width, g.Height - 1)
' Fill in using the system Fill color
g.ForeColor = FillColor
g.FillRect(2, 2, g.Width - 3, g.Height - 3)
```

## Compatibility

All project types on all supported operating systems.

## See also

`Color.DarkBevelColor<color.darkbevelcolor>`, `Color.DarkTingeColor<color.darktingecolor>`, `Color.DisabledTextColor<color.disabledtextcolor>`, `Color.FillColor<color.fillcolor>`, `Color.HighlightColor<color.highlightcolor>`, `Color.LightBevelColor<color.lightbevelcolor>`, `Color.LightTingeColor<color.lighttingecolor>`, `Color.TextColor<color.textcolor>` functions; `Color</api/data_types/color>` data type; `Supporting Dark Mode</topics/user_interface/supporting_dark_mode>` topic.
