# Titanium.UI.Color

> Represents a color used for UI components.

- Source: https://titaniumsdk.com/docs/sdk/12.6.4/Titanium.UI.Color
- Titanium SDK version: 12.6.4
- Kind: proxy
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 9.1.0
- Extends: Titanium.Proxy
- Inheritance: Titanium.Proxy

This type may be used on iOS for assignment to any property typically taking a String color value.
A developer is not expected to typically interact with a [Titanium.UI.Color](https://titaniumsdk.com/docs/sdk/Titanium.UI.Color.md) object, as we generate them
under the hood when converting the passed in String representations. One major exception is use of the 
[Titanium.UI.fetchSemanticColor](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#fetchSemanticColor) method, which will return an instance to be passed to UI components.
This instance will automatically "adapt" the receiver to light/dark mode changes.

The only current instance you'd receive this type on Android is through the [Titanium.UI.Android.getColorResource](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#getColorResource) method.
Note that Android does not currently support passing in instances of this type for UI components/properties!
You must convert to a hex string representation to pass this in to any color properties on Android.

See [UI Element Colors](https://developer.apple.com/documentation/uikit/uicolor/ui_element_colors?language=objc) and
[Standard Colors](https://developer.apple.com/documentation/uikit/uicolor/standard_colors?language=objc) for lists of
named colors to pass to [Titanium.UI.fetchSemanticColor](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#fetchSemanticColor) on iOS.

See [R.color](https://developer.android.com/reference/android/R.color) for a list of system color names to use to pass to
[Titanium.UI.Android.getColorResource](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#getColorResource) on Android.

## Methods

### toHex

- Platforms: Android, iPhone, iPad, macOS

Returns a hex string representation of the color (in the RRGGBB or AARRGGBB formats)

The returned value is an uppercase hex representation of the color with a leading `'#'`. If fully opaque,
the alpha hex values will be omitted. For example, black would return `'#000000'`. Black with a 50% opacity
would return `'#80000000'`

Returns: String

## Inherited members

7 members are inherited. Each is documented on the type that declares it.

- [Titanium.Proxy](https://titaniumsdk.com/docs/sdk/12.6.4/Titanium.Proxy.md): `addEventListener`, `apiName`, `applyProperties`, `bubbleParent`, `fireEvent`, `lifecycleContainer`, `removeEventListener`

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.