vcl-dxcoregraphics-8dbbc076.md
Stores TdxAlphaColor equivalents of predefined TColor constants and implements auxiliary color-related methods.
TdxAlphaColors = record
The TdxAlphaColors record contains TdxAlphaColor constants and declares multiple color-related utility methods.
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.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.
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:
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. |
DefaultStores the default TdxAlphaColor value that corresponds to a skin-determined color.EmptyAn empty TdxAlphaColor constant whose alpha and color values are set to zero.TransparentStores the transparent TdxAlphaColor value (corresponds to the white color with zero alpha).
Alpha | B | G | RReturn corresponding color channel values (from 0 to 255) for a specified TdxAlphaColor.BlendBlends two TdxAlphaColor values (foreground and background colors) to create an opaque color.CalculateNearestColorUses the HSL (HSB) color model to compare a specified color to all colors in a palette and returns the most similar color.ChangeBrightnessCreates a new TdxAlphaColor value based on a specified color and the required brightness value (from 0.0 to 1.0).GetBrightness | GetHue | GetSaturationReturn brightness (lightness), hue, and saturation values (from 0.0 to 1.0) for a specified TdxAlphaColor.IsEmpty | IsTransparentOrEmptyIdentify if a specified color matches the Empty or Transparent special color.
FromArgbCreates a TdxAlphaColor from specified individual component values.FromColorConverts a TColor value to TdxAlphaColor (opaque).FromHSLCreates a TdxAlphaColor from hue, saturation, and brightness (lightness) values (from 0.0 to 1.0).FromHTMLConverts a hexadecimal HTML color value to TdxAlphaColor (opaque).ToColorConverts a TdxAlphaColor value to TColor.ToHSLReturns hue, saturation, and brightness (lightness) values for a specified [TdxAlphaColor] value.ToHTMLConverts a TdxAlphaColor value to the HTML hexadecimal format.
In addition to all methods declared in the TdxAlphaColors record, you can use global color-related methods (also declared in the dxCoreGraphics unit).
dxAlphaColorToColor(dxCoreGraphics.TdxAlphaColor)dxAlphaColorToColor(dxCoreGraphics.TdxAlphaColor,System.Byte)Converts a specified TdxAlphaColor value to the TColor type.dxAlphaColorToRGBQuadConverts a specified TdxAlphaColor value to the TRGBQuad type.dxColorToAlphaColorConverts a specified TColor value to the TdxAlphaColor type.dxColorToRGBQuadConverts 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.dxRGBQuadToColorConverts a specified TRGBQuad value to the TColor type.
dxGetAlphaExtracts the alpha value (also called transparency level) from a specified color.dxGetBlueExtracts the blue color component value from a specified color.dxGetGreenExtracts the green color component value from a specified color.dxGetRedExtracts the red color component value from a specified color. See Also