SysColorCtrl Control object
The SysColorCtrl control is used on a taskpad DHTML page to get system color settings that can be applied to the taskpad. The control also has methods to derive colors based on one or more specified colors.
The MMC taskpad templates use the SysColorCtrl control. To create a custom taskpad that uses the system colors, the SysColorCtrl control should be placed as an object on the taskpad HTML page and its methods should be used to get system color values for use on the taskpad DHTML page. Optionally, your taskpad HTML page can use the methods to derive other colors (blend two colors, or lighten or darken a color) from a specified color.
The CLSID for SysColorCtrl is C47195EC-CD7A-11D1-8EA3-00C04F9900D7.
Members
The SysColorCtrl Control object has these types of members:
Events
The SysColorCtrl Control object has these events.
| Event | Description |
|---|---|
| SysColorChange | A system color change has occurred. |
Methods
The SysColorCtrl Control object has these methods.
| Method | Description |
|---|---|
| ConvertHexToRGB | Converts a hexadecimal value to RGB. |
| ConvertRGBToHex | Converts an RGB value to hexadecimal. |
| Get3QuarterDarkHex | Derives a "darker" color by calculating a color that is blended 75% between a given color and black. Returns as a hexadecimal value. |
| Get3QuarterDarkRGB | Derives a "darker" color by calculating a color that is blended 75% between a given color and black. Returns as an RGB value. |
| Get3QuarterLightHex | Derives a "lighter" color by calculating a color that is blended 75% between a given color and white. Returns as a hexadecimal value. |
| Get3QuarterLightRGB | Derives a "lighter" color by calculating a color that is blended 75% between a given color and white. Returns as an RGB value. |
| GetBlueFromRGB | Gets the blue value from an RGB value. |
| GetDerivedHex | Derives a color based on a starting color, a color to move toward, and a percentage to move toward that color. Returns as a hexadecimal value. |
| GetDerivedRGB | Derives a color based on a starting color, a color to move toward, and a percentage to move toward that color. Returns as an RGB value. |
| GetGreenFromRGB | Gets the green value from an RGB value. |
| GetHalfDarkHex | Derives a "darker" color by calculating a color that is blended 50% between a given color and black. Returns as a hexadecimal value. |
| GetHalfDarkRGB | Derives a "darker" color by calculating a color that is blended 50% between a given color and black. Returns as an RGB value. |
| GetHalfLightHex | Derives a "lighter" color by calculating a color that is blended 50% between a given color and white. Returns as a hexadecimal value. |
| GetHalfLightRGB | Derives a "lighter" color by calculating a color that is blended 50% between a given color and white. Returns as an RGB value. |
| GetQuarterDarkHex | Derives a "darker" color by calculating a color that is blended 25% between a given color and black. Returns as a hexadecimal value. |
| GetQuarterDarkRGB | Derives a "darker" color by calculating a color that is blended 25% between a given color and black. Returns as an RGB value. |
| GetQuarterLightHex | Derives a "lighter" color by calculating a color that is blended 25% between a given color and white. Returns as a hexadecimal value. |
| GetQuarterLightRGB | Derives a "lighter" color by calculating a color that is blended 25% between a given color and white. Returns as an RGB value. |
| GetRedFromRGB | Gets the red value from an RGB value. |
Properties
The SysColorCtrl Control object has these properties.
| Property | Description |
|---|---|
| HEXactiveborder |
Active border color, in HEX. |
| HEXactivecaption |
Active caption color, in HEX. |
| HEXappworkspace |
Application workspace color, in HEX. |
| HEXbackground |
Background color, in HEX. |
| HEXbuttonface |
Button face color, in HEX. |
| HEXbuttonhighlight |
Button highlight color, in HEX. |
| HEXbuttonshadow |
Button shadow color, in HEX. |
| HEXbuttontext |
Button text color, in HEX. |
| HEXcaptiontext |
Caption text color, in HEX. |
| HEXgraytext |
Gray text color, in HEX. |
| HEXhighlight |
Highlight color, in HEX. |
| HEXhighlighttext |
Highlight text color, in HEX. |
| HEXinactiveborder |
Inactive border color, in HEX. |
| HEXinactivecaption |
Inactive caption color, in HEX. |
| HEXinactivecaptiontext |
Inactive caption text color, in HEX. |
| HEXinfobackground |
Information background color, in HEX. |
| HEXinfotext |
Information text color, in HEX. |
| HEXmenu |
Menu color, in HEX. |
| HEXmenutext |
Menu text color, in HEX. |
| HEXscrollbar |
Scrollbar color, in HEX. |
| HEXthreeddarkshadow |
3D dark shadow color, in HEX. |
| HEXthreedface |
3D face color, in HEX. |
| HEXthreedhighlight |
3D highlight color, in HEX. |
| HEXthreedlightshadow |
3D light shadow color, in HEX. |
| HEXthreedshadow |
3D shadow color, in HEX. |
| HEXwindow |
Window color, in HEX. |
| HEXwindowframe |
Window frame color, in HEX. |
| HEXwindowtext |
Window text color, in HEX. |
| RGBactiveborder |
Active border color, in RGB. |
| RGBactivecaption |
Active caption color, in RGB. |
| RGBappworkspace |
Application workspace color, in RGB. |
| RGBbackground |
Background color, in RGB. |
| RGBbuttonface |
Button face color, in RGB. |
| RGBbuttonhighlight |
Button highlight color, in RGB. |
| RGBbuttonshadow |
Button shadow color, in RGB. |
| RGBbuttontext |
Button text color, in RGB. |
| RGBcaptiontext |
Caption text color, in RGB. |
| RGBgraytext |
Gray text color, in RGB. |
| RGBhighlight |
Highlight color, in RGB. |
| RGBhighlighttext |
Highlight text color, in RGB. |
| RGBinactiveborder |
Inactive border color, in RGB. |
| RGBinactivecaption |
Inactive caption color, in RGB. |
| RGBinactivecaptiontext |
Inactive caption text color, in RGB. |
| RGBinfobackground |
Information background color, in RGB. |
| RGBinfotext |
Information text color, in RGB. |
| RGBmenu |
Menu color, in RGB. |
| RGBmenutext |
Menu text color, in RGB. |
| RGBscrollbar |
Scrollbar color, in RGB. |
| RGBthreeddarkshadow |
3D dark shadow color, in RGB. |
| RGBthreedface |
3D face color, in RGB. |
| RGBthreedhighlight |
3D highlight color, in RGB. |
| RGBthreedlightshadow |
3D light shadow color, in RGB. |
| RGBthreedshadow |
3D shadow color, in RGB. |
| RGBwindow |
Window color, in RGB. |
| RGBwindowframe |
Window frame color, in RGB. |
| RGBwindowtext |
Window text color, in RGB. |
Requirements
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Header |
|
| IDL |
|
| DLL |
|