TdxAlphaColors Record

Stores TdxAlphaColor equivalents of predefined TColor constants and implements auxiliary color-related methods.

Declaration

Delphi

TdxAlphaColors = record

Remarks

The TdxAlphaColors record contains TdxAlphaColor constants and declares multiple color-related utility methods.

How to Use TdxAlphaColors

1. Add the dxCoreGraphics unit to the uses clause of your project (in Delphi) or include the dxCoreGraphics header to the required source code file (in C++Builder).
2. Use the TdxAlphaColors type name together with a scope resolution token (. in Delphi or :: in C++Builder) followed by the required API member. For example, write TdxAlphaColors.Default (in Delphi) or TdxAlphaColors::Default (in C++Builder) to use the default (skin-determined) TdxAlphaColor value in your code.

Main API Members

The list below outlines key members of the TdxAlphaColors record. These members allow you to use TdxAlphaColor equivalents of corresponding TColor constants for all DevExpress controls that use transparent colors.

Predefined Colors

This section contains all predefined color constants declared in the TdxAlphaColors record. Click Standard Colors, Web Colors, or System Colors below to view corresponding TdxAlphaColor palettes.

Note

All TdxAlphaColor values in this section are opaque (their alpha value is 255 ($FF)).

To create colors with a custom transparency, pass the corresponding constants as a parameter to the TdxAlphaColors.FromArgb function or use other auxiliary color-related functions declared in the dxCoreGraphics unit.

Refer to the following section for details: Global TdxAlphaColor-Related Methods.

Standard Colors

The following table lists TdxAlphaColor counterparts of TColor values found in the Normal Colors VCL palette:

TdxAlphaColor	Hexadecimal	Color Fill Swatch	TColor
TdxAlphaColors.Black	$FF000000		clBlack
TdxAlphaColors.Maroon	$FF000080		clMaroon
TdxAlphaColors.Green	$FF008000		clGreen
TdxAlphaColors.Olive	$FF008080		clOlive
TdxAlphaColors.Navy	$FF800000		clNavy
TdxAlphaColors.Purple	$FF800080		clPurple
TdxAlphaColors.Teal	$FF808000		clTeal
TdxAlphaColors.Gray	$FF808080		clGray
TdxAlphaColors.Silver	$FFC0C0C0		clSilver
TdxAlphaColors.Red	$FF0000FF		clRed
TdxAlphaColors.Lime	$FF00FF00		clLime
TdxAlphaColors.Yellow	$FF00FFFF		clYellow
TdxAlphaColors.Blue	$FFFF0000		clBlue
TdxAlphaColors.Fuchsia	$FFFF00FF		clFuchsia
TdxAlphaColors.Aqua	$FFFFFF00		clAqua
TdxAlphaColors.White	$FFFFFFFF		clWhite
TdxAlphaColors.SkyBlue	$FFF0CAA6		clSkyBlue

Web Colors

The following table lists TdxAlphaColor equivalents of all TColor values found in the Web Named Color VCL palette:

TdxAlphaColor	Hexadecimal	Color Fill Swatch	TColor
TdxAlphaColors.Snow	$FFFAFAFF		clWebSnow
TdxAlphaColors.FloralWhite	$FFF0FAFF		clWebFloralWhite
TdxAlphaColors.LavenderBlush	$FFF5F0FF		clWebLavenderBlush
TdxAlphaColors.OldLace	$FFE6F5FD		clWebOldLace
TdxAlphaColors.Ivory	$FFF0FFFF		clWebIvory
TdxAlphaColors.Cornsilk	$FFDCF8FF		clWebCornSilk
TdxAlphaColors.Beige	$FFDCF5F5		clWebBeige
TdxAlphaColors.AntiqueWhite	$FFD7EBFA		clWebAntiqueWhite
TdxAlphaColors.Wheat	$FFB3DEF5		clWebWheat
TdxAlphaColors.AliceBlue	$FFFFF8F0		clWebAliceBlue
TdxAlphaColors.GhostWhite	$FFFFF8F8		clWebGhostWhite
TdxAlphaColors.Lavender	$FFFAE6E6		clWebLavender
TdxAlphaColors.SeaShell	$FFEEF5FF		clWebSeashell
TdxAlphaColors.LightYellow	$FFE0FFFF		clWebLightYellow
TdxAlphaColors.PapayaWhip	$FFD5EFFF		clWebPapayaWhip
TdxAlphaColors.NavajoWhite	$FFADDEFF		clWebNavajoWhite
TdxAlphaColors.Moccasin	$FFB5E4FF		clWebMoccasin
TdxAlphaColors.BurlyWood	$FF87B8DE		clWebBurlywood
TdxAlphaColors.Azure	$FFFFFFF0		clWebAzure
TdxAlphaColors.MintCream	$FFFAFFF5		clWebMintcream
TdxAlphaColors.Honeydew	$FFF0FFF0		clWebHoneydew
TdxAlphaColors.Linen	$FFFAF0E6		clWebLinen
TdxAlphaColors.LemonChiffon	$FFCDFAFF		clWebLemonChiffon
TdxAlphaColors.BlanchedAlmond	$FFCDEBFF		clWebBlanchedAlmond
TdxAlphaColors.Bisque	$FFC4E4FF		clWebBisque
TdxAlphaColors.PeachPuff	$FFB9DAFF		clWebPeachPuff
TdxAlphaColors.Tan	$FF8CB4D2		clWebTan
TdxAlphaColors.Yellow	$FF00FFFF		clWebYellow
TdxAlphaColors.DarkOrange	$FF008CFF		clWebDarkOrange
TdxAlphaColors.Red	$FF0000FF		clWebRed
TdxAlphaColors.DarkRed	$FF00008B		clWebDarkRed
TdxAlphaColors.Maroon	$FF000080		clWebMaroon
TdxAlphaColors.IndianRed	$FF5C5CCD		clWebIndianRed
TdxAlphaColors.Salmon	$FF7280FA		clWebSalmon
TdxAlphaColors.Coral	$FF507FFF		clWebCoral
TdxAlphaColors.Gold	$FF00D7FF		clWebGold
TdxAlphaColors.Tomato	$FF4763FF		clWebTomato
TdxAlphaColors.Crimson	$FF3C14DC		clWebCrimson
TdxAlphaColors.Brown	$FF2A2AA5		clWebBrown
TdxAlphaColors.Chocolate	$FF1E69D2		clWebChocolate
TdxAlphaColors.SandyBrown	$FF60A4F4		clWebSandyBrown
TdxAlphaColors.LightSalmon	$FF7AA0FF		clWebLightSalmon
TdxAlphaColors.LightCoral	$FF8080F0		clWebLightCoral
TdxAlphaColors.Orange	$FF00A5FF		clWebOrange
TdxAlphaColors.OrangeRed	$FF0045FF		clWebOrangeRed
TdxAlphaColors.Firebrick	$FF2222B2		clWebFirebrick
TdxAlphaColors.SaddleBrown	$FF13458B		clWebSaddleBrown
TdxAlphaColors.Sienna	$FF2D52A0		clWebSienna
TdxAlphaColors.Peru	$FF3F85CD		clWebPeru
TdxAlphaColors.DarkSalmon	$FF7A96E9		clWebDarkSalmon
TdxAlphaColors.RosyBrown	$FF8F8FBC		clWebRosyBrown
TdxAlphaColors.PaleGoldenrod	$FFAAE8EE		clWebPaleGoldenrod
TdxAlphaColors.LightGoldenrodYellow	$FFD2FAFA		clWebLightGoldenrodYellow
TdxAlphaColors.Olive	$FF008080		clWebOlive
TdxAlphaColors.ForestGreen	$FF228B22		clWebForestGreen
TdxAlphaColors.GreenYellow	$FF2FFFAD		clWebGreenYellow
TdxAlphaColors.Chartreuse	$FF00FF7F		clWebChartreuse
TdxAlphaColors.LightGreen	$FF90EE90		clWebLightGreen
TdxAlphaColors.Aquamarine	$FFD4FF7F		clWebAquamarine
TdxAlphaColors.SeaGreen	$FF578B2E		clWebSeaGreen
TdxAlphaColors.Goldenrod	$FF20A5DA		clWebGoldenRod
TdxAlphaColors.Khaki	$FF8CE6F0		clWebKhaki
TdxAlphaColors.OliveDrab	$FF238E6B		clWebOliveDrab
TdxAlphaColors.Green	$FF008000		clWebGreen
TdxAlphaColors.YellowGreen	$FF32CD9A		clWebYellowGreen
TdxAlphaColors.LawnGreen	$FF00FC7C		clWebLawnGreen
TdxAlphaColors.PaleGreen	$FF98FB98		clWebPaleGreen
TdxAlphaColors.MediumAquamarine	$FFAACD66		clWebMediumAquamarine
TdxAlphaColors.MediumSeaGreen	$FF71B33C		clWebMediumSeaGreen
TdxAlphaColors.DarkGoldenrod	$FF0B86B8		clWebDarkGoldenRod
TdxAlphaColors.DarkKhaki	$FF6BB7BD		clWebDarkKhaki
TdxAlphaColors.DarkOliveGreen	$FF2F6B55		clWebDarkOliveGreen
TdxAlphaColors.DarkGreen	$FF006400		clWebDarkGreen
TdxAlphaColors.LimeGreen	$FF32CD32		clWebLimeGreen
TdxAlphaColors.Lime	$FF00FF00		clWebLime
TdxAlphaColors.SpringGreen	$FF7FFF00		clWebSpringGreen
TdxAlphaColors.MediumSpringGreen	$FF9AFA00		clWebMediumSpringGreen
TdxAlphaColors.DarkSeaGreen	$FF8FBC8F		clWebDarkSeaGreen
TdxAlphaColors.LightSeaGreen	$FFAAB220		clWebLightSeaGreen
TdxAlphaColors.PaleTurquoise	$FFEEEEAF		clWebPaleTurquoise
TdxAlphaColors.LightCyan	$FFFFFFE0		clWebLightCyan
TdxAlphaColors.LightBlue	$FFE6D8AD		clWebLightBlue
TdxAlphaColors.LightSkyBlue	$FFFACE87		clWebLightSkyBlue
TdxAlphaColors.CornflowerBlue	$FFED9564		clWebCornFlowerBlue
TdxAlphaColors.DarkBlue	$FF8B0000		clWebDarkBlue
TdxAlphaColors.Indigo	$FF82004B		clWebIndigo
TdxAlphaColors.MediumTurquoise	$FFCCD148		clWebMediumTurquoise
TdxAlphaColors.Turquoise	$FFD0E040		clWebTurquoise
TdxAlphaColors.Cyan	$FFFFFF00		clWebCyan
TdxAlphaColors.PowderBlue	$FFE6E0B0		clWebPowderBlue
TdxAlphaColors.SkyBlue	$FFEBCE87		clWebSkyBlue
TdxAlphaColors.RoyalBlue	$FFE16941		clWebRoyalBlue
TdxAlphaColors.MediumBlue	$FFCD0000		clWebMediumBlue
TdxAlphaColors.MidnightBlue	$FF701919		clWebMidnightBlue
TdxAlphaColors.DarkTurquoise	$FFD1CE00		clWebDarkTurquoise
TdxAlphaColors.CadetBlue	$FFA09E5F		clWebCadetBlue
TdxAlphaColors.DarkCyan	$FF8B8B00		clWebDarkCyan
TdxAlphaColors.Teal	$FF808000		clWebTeal
TdxAlphaColors.DeepSkyBlue	$FFFFBF00		clWebDeepskyBlue
TdxAlphaColors.DodgerBlue	$FFFF901E		clWebDodgerBlue
TdxAlphaColors.Blue	$FFFF0000		clWebBlue
TdxAlphaColors.Navy	$FF800000		clNavy
TdxAlphaColors.DarkViolet	$FFD30094		clWebDarkViolet
TdxAlphaColors.DarkOrchid	$FFCC3299		clWebDarkOrchid
TdxAlphaColors.Magenta	$FFFF00FF		clWebMagenta
TdxAlphaColors.DarkMagenta	$FF8B008B		clWebDarkMagenta
TdxAlphaColors.MediumVioletRed	$FF8515C7		clWebMediumVioletRed
TdxAlphaColors.PaleVioletRed	$FF9370DB		clWebPaleVioletRed
TdxAlphaColors.BlueViolet	$FFE22B8A		clWebBlueViolet
TdxAlphaColors.MediumOrchid	$FFD355BA		clWebMediumOrchid
TdxAlphaColors.MediumPurple	$FFDB7093		clWebMediumPurple
TdxAlphaColors.Purple	$FF800080		clWebPurple
TdxAlphaColors.DeepPink	$FF9314FF		clWebDeepPink
TdxAlphaColors.LightPink	$FFC1B6FF		clWebLightPink
TdxAlphaColors.Violet	$FFEE82EE		clWebViolet
TdxAlphaColors.Orchid	$FFD670DA		clWebOrchid
TdxAlphaColors.Plum	$FFDDA0DD		clWebPlum
TdxAlphaColors.Thistle	$FFD8BFD8		clWebThistle
TdxAlphaColors.HotPink	$FFB469FF		clWebHotPink
TdxAlphaColors.Pink	$FFCBC0FF		clWebPink
TdxAlphaColors.LightSteelBlue	$FFDEC4B0		clWebLightSteelBlue
TdxAlphaColors.MediumSlateBlue	$FFEE687B		clWebMediumSlateBlue
TdxAlphaColors.LightSlateGray	$FF998877		clWebLightSlateGray
TdxAlphaColors.White	$FFFFFFFF		clWebWhite
TdxAlphaColors.LightGray	$FFD3D3D3		clWebLightgrey
TdxAlphaColors.Gray	$FF808080		clWebGray
TdxAlphaColors.SteelBlue	$FFB48246		clWebSteelBlue
TdxAlphaColors.SlateBlue	$FFCD5A6A		clWebSlateBlue
TdxAlphaColors.SlateGray	$FF908070		clWebSlateGray
TdxAlphaColors.WhiteSmoke	$FFF5F5F5		clWebWhiteSmoke
TdxAlphaColors.Silver	$FFC0C0C0		clWebSilver
TdxAlphaColors.DimGray	$FF696969		clWebDimGray
TdxAlphaColors.MistyRose	$FFE1E4FF		clWebMistyRose
TdxAlphaColors.DarkSlateBlue	$FF8B3D48		clWebDarkSlateBlue
TdxAlphaColors.DarkSlateGray	$FF4F4F2F		clWebDarkSlateGray
TdxAlphaColors.Gainsboro	$FFDCDCDC		clWebGainsboro
TdxAlphaColors.DarkGray	$FFA9A9A9		clWebDarkGray
TdxAlphaColors.Black	$FF000000		clWebBlack

System Colors

The following table lists all class functions that return TdxAlphaColor counterparts of colors defined in the Windows Control panel:

TdxAlphaColor	TColor	Description
TdxAlphaColors.ActiveBorder	clActiveBorder	The active window border color.
TdxAlphaColors.ActiveCaption	clActiveCaption	The active window title bar color.
TdxAlphaColors.AppWorkSpace	clAppWorkSpace	The current application workspace color.
TdxAlphaColors.Background	clBackground	The Windows desktop background color.
TdxAlphaColors.BtnFace	clBtnFace	The button face color.
TdxAlphaColors.BtnHighlight	clBtnHighlight	The button highlight color.
TdxAlphaColors.BtnShadow	clBtnShadow	The button shadow color.
TdxAlphaColors.BtnText	clBtnText	The button caption color.
TdxAlphaColors.CaptionText	clCaptionText	The active window title text color.
TdxAlphaColors.GradientActiveCaption	clGradientActiveCaption	The end point of the gradient used to fill the title bar of the active window in Windows 2000. Used for backward compatibility only.
TdxAlphaColors.GradientInactiveCaption	clGradientInactiveCaption	The end point of the gradient used to fill title bars of inactive windows in Windows 2000. Used for backward compatibility only.
TdxAlphaColors.GrayText	clGrayText	The dimmed text color.
TdxAlphaColors.Highlight	clHighlight	The selected text color.
TdxAlphaColors.HotLight	clHotLight	The hot-track effect color.
TdxAlphaColors.InactiveBorder	clInactiveBorder	The border color for inactive windows.
TdxAlphaColors.InactiveCaptionText	clInactiveCaptionText	The title text color for inactive windows.
TdxAlphaColors.InfoBk	clInfoBk	The background color for tooltip controls in Windows 95. Used for backward compatibility only.
TdxAlphaColors.InfoText	clInfoText	The text color for tooltip controls in Window 95. Used for backward compatibility only.
TdxAlphaColors.Menu	clMenu	The menu background color.
TdxAlphaColors.MenuBar	clMenuBar	The menu bar color.
TdxAlphaColors.MenuHighlight	clMenuHighlight	The menu item highlight color.
TdxAlphaColors.MenuText	clMenuText	The menu text color.
TdxAlphaColors.ScrollBar	clScrollBar	The scroll bar track color.
TdxAlphaColors._3DDkShadow	cl3DDkShadow	The dark shadow color for UI elements with 3D effects in Windows 95. Used for backward compatibility only.
TdxAlphaColors._3DLight	cl3DLight	The light color for UI elements with 3D effects in Windows 95. Used for backward compatibility only.
TdxAlphaColors.Window	clWindow	The window background color.
TdxAlphaColors.WindowFrame	clWindowFrame	The window frame color.
TdxAlphaColors.WindowText	clWindowText	The window text color.

Special Colors

Default

Stores the default TdxAlphaColor value that corresponds to a skin-determined color.

Empty

An empty TdxAlphaColor constant whose alpha and color values are set to zero.

Transparent

Stores the transparent TdxAlphaColor value (corresponds to the white color with zero alpha).

Auxiliary Functions

Alpha | B | G | R

Return corresponding color channel values (from 0 to 255) for a specified TdxAlphaColor.

Blend

Blends two TdxAlphaColor values (foreground and background colors) to create an opaque color.

CalculateNearestColor

Uses the HSL (HSB) color model to compare a specified color to all colors in a palette and returns the most similar color.

ChangeBrightness

Creates a new TdxAlphaColor value based on a specified color and the required brightness value (from 0.0 to 1.0).

GetBrightness | GetHue | GetSaturation

Return brightness (lightness), hue, and saturation values (from 0.0 to 1.0) for a specified TdxAlphaColor.

IsEmpty | IsTransparentOrEmpty

Identify if a specified color matches the Empty or Transparent special color.

Color Conversion Functions

FromArgb

Creates a TdxAlphaColor from specified individual component values.

FromColor

Converts a TColor value to TdxAlphaColor (opaque).

FromHSL

Creates a TdxAlphaColor from hue, saturation, and brightness (lightness) values (from 0.0 to 1.0).

FromHTML

Converts a hexadecimal HTML color value to TdxAlphaColor (opaque).

ToColor

Converts a TdxAlphaColor value to TColor.

ToHSL

Returns hue, saturation, and brightness (lightness) values for a specified [TdxAlphaColor] value.

ToHTML

Converts a TdxAlphaColor value to the HTML hexadecimal format.

Global TdxAlphaColor-Related Methods

In addition to all methods declared in the TdxAlphaColors record, you can use global color-related methods (also declared in the dxCoreGraphics unit).

Conversion Methods

dxAlphaColorToColor(dxCoreGraphics.TdxAlphaColor)

dxAlphaColorToColor(dxCoreGraphics.TdxAlphaColor,System.Byte)

Converts a specified TdxAlphaColor value to the TColor type.

dxAlphaColorToRGBQuad

Converts a specified TdxAlphaColor value to the TRGBQuad type.

dxColorToAlphaColor

Converts a specified TColor value to the TdxAlphaColor type.

dxColorToRGBQuad

Converts a specified TColor value to the TRGBQuad type.

dxMakeAlphaColor(System.Byte,System.Byte,System.Byte)

dxMakeAlphaColor(System.Byte,System.Byte,System.Byte,System.Byte)

dxMakeAlphaColor(Vcl.Graphics.TColor,System.Byte)

Creates a TdxAlphaColor value from individual color component values and returns it as the function’s result.

dxRGBQuadToColor

Converts a specified TRGBQuad value to the TColor type.

Utility Methods

dxGetAlpha

Extracts the alpha value (also called transparency level) from a specified color.

dxGetBlue

Extracts the blue color component value from a specified color.

dxGetGreen

Extracts the green color component value from a specified color.

dxGetRed

Extracts the red color component value from a specified color.