SysColorCtrl.GetDerivedHex method
The GetDerivedHex method derives a color based on a starting color, a color to move toward, and a percentage to move toward that color. It is returned as a hexadecimal value.
Syntax
SysColorCtrl.GetDerivedHex( _
ByVal pszFrom, _
ByVal pszTo, _
ByVal pszFormat, _
ByVal nPercent _
)
Parameters
-
pszFrom [in]
-
A string that contains the color you want to use as the starting color. The contents of the string depend on the format specified in the pszFormat parameter.
-
pszTo [in]
-
A string that contains the color to move toward.
-
pszFormat [in]
-
A string that contains the name of the format that is being passed in the pszFrom and pszTo parameters.
-
CSS
-
Name of the display element whose color you want to specify. See System Color Values for Color Derivation Methods.
-
HEX
-
Hexadecimal form of the color. For example, specify FFFFFF for white.
-
RGB
-
RGB form of the color. For example, specify 16777215 for white.
nPercent
An integer that represents the percentage (0 to 100) between the pszFrom and pszTo colors. This value represents what percentage of the pszTo color should be blended with the pszFrom color. For example, a value of 0 would return the pszFrom color, a value of 50 would return a color that was halfway between pszFrom and pszTo, and a value of 100 would return the pszTo color. This value must be between 0 and 100.
Return value
A string that contains the hexadecimal value for the derived color specified by the method's parameters.
Examples
The following HTML page embeds the SysColorCtrl control as an object and uses the GetDerivedHex method to set the background color of the page to color that is 50% between the system color settings for activecaption and activeborder.
<html>
<head>
<object
ID="SysColorX"
classid="clsid:C47195EC-CD7A-11D1-8EA3-00C04F9900D7"
width=0
height=0>
</object>
<script language=javascript>
function init() {
color1 = "activecaption";
color2 = "activeborder";
pcnt = 50;
document.body.bgColor=SysColorX.GetDerivedHex(color1, color2,'CSS',pcnt);
}
</script>
</head>
<body onload="init()">
</body>
</html>
Requirements
| Redistributable |
MMC 1.1 or later |
| DLL |
|