Opens the system color-selection dialog box.
Syntax
rgbColor = Dialog Helper.ChooseColorDlg( [initColor])
Parameters
initColor Optional. A Variant that specifies the RGB value of the initial color selected in the color-selection dialog box. The value is specified as 0xrrggbb where rr is the red hex value, gg is the green hex value, and bb is the blue hex value. For a complete list of colors, see Color Table.
0xrrggbb
rr
red
gg
green
bb
blue
Return Value
A Variant that specifies the decimal value of the color chosen in the color-selection dialog box. The value must be converted to its hexadecimal equivalent and is specified as 0xrrggbb.
Remarks
ChooseColorDlg was introduced in Microsoft Internet Explorer 6.There is no way to persist custom colors in this dialog box.The return value of this method must be converted from decimal to hexadecimal before it can be used to change the collor of an object. The hexadecimal number must contain six digits to represent the RRGGBB schema required by the color table. For numbers with less than six numbers, concatenate zeros to the beginning of the number. For more information, see the Color Table.
ChooseColorDlg was introduced in Microsoft Internet Explorer 6.
There is no way to persist custom colors in this dialog box.
The return value of this method must be converted from decimal to hexadecimal before it can be used to change the collor of an object. The hexadecimal number must contain six digits to represent the RRGGBB schema required by the color table. For numbers with less than six numbers, concatenate zeros to the beginning of the number. For more information, see the Color Table.
Example
The following example shows how to call the color dialog box. The return value of the method is converted to a hexadecimal value and applied to the font color. //This variable must have global scope for the callColorDlg function to persist the chosen color var sInitColor = null; function callColorDlg(){ //if sInitColor is null, the color dialog box has not yet been called if (sInitColor == null) var sColor = dlgHelper.ChooseColorDlg(); else //call the dialog box and initialize the color to the color previously chosen var sColor = dlgHelper.ChooseColorDlg(sInitColor); //change the return value from a decimal value to a hex value and make sure the value has 6 //digits to represent the RRGGBB schema required by the color table sColor = sColor.toString(16); if (sColor.length < 6) { var sTempString = "000000".substring(0,6-sColor.length); sColor = sTempString.concat(sColor); } document.execCommand("ForeColor", false, sColor); //set the initialization color to the color chosen sInitColor = sColor; } This feature requires Microsoft® Internet Explorer 6.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
The following example shows how to call the color dialog box. The return value of the method is converted to a hexadecimal value and applied to the font color.
//This variable must have global scope for the callColorDlg function to persist the chosen color var sInitColor = null; function callColorDlg(){ //if sInitColor is null, the color dialog box has not yet been called if (sInitColor == null) var sColor = dlgHelper.ChooseColorDlg(); else //call the dialog box and initialize the color to the color previously chosen var sColor = dlgHelper.ChooseColorDlg(sInitColor); //change the return value from a decimal value to a hex value and make sure the value has 6 //digits to represent the RRGGBB schema required by the color table sColor = sColor.toString(16); if (sColor.length < 6) { var sTempString = "000000".substring(0,6-sColor.length); sColor = sTempString.concat(sColor); } document.execCommand("ForeColor", false, sColor); //set the initialization color to the color chosen sInitColor = sColor; }
Applies To
Dialog Helper
For this code to work, you need to add:
<OBJECT id=dlgHelper CLASSID="clsid:3050f819-98b5-11cf-bb82-00aa00bdce0b" width="0px" height="0px"></OBJECT>
to the body of your html.
The sample code is correct, and the description at the top of this page is incorrect.
initColor must be specified as a six character (rrggbb) String. So, for green you must specify "00ff00", and not "0x00ff00", nor 0x00ff00 (integer value).
Experience Silverlight enabled quickstart tutorials, video training, showcases & more.
By clicking "Click to Install" you accept the Silverlight License Agreement .Silverlight updates automatically, learn more .