colorDepth Property | Internet Development Index |
Retrieves the number of bits per pixel used for colors on the destination device or buffer.
Syntax
XML N/A Scripting [ iBitsPerPixel = ] clientCaps.colorDepth
Possible Values
iBitsPerPixel Integer that receives one of the following values:
1, 4, 8, 15, 16, 24, 32 Off-screen buffering occurs based on the specified number of bits per pixel. The value 15 specifies 16 bits per pixel, in which only 15 bits are used in a 5-5-5 layout of red-green-blue (RGB) values. The property is read-only. The property has no default value.
Remarks
To select an appropriate color to return to the browser, retrieve the property's value through script.
If bufferDepth is 0 or -1, colorDepth is equal to the bits-per-pixel value for the screen or printer. If bufferDepth is nonzero, colorDepth is equal to bufferDepth.
Example
This example displays all the properties available through the clientCaps behavior.
<HTML xmlns:IE> <HEAD> <STYLE> @media all { IE\:CLIENTCAPS {behavior:url(#default#clientCaps)} } </STYLE> <SCRIPT> function window.onload() { sTempStr = "availHeight = " + oClientCaps.availHeight + "\n" + "availWidth = " + oClientCaps.availWidth + "\n" + "bufferDepth = " + oClientCaps.bufferDepth + "\n" + "colorDepth = " + oClientCaps.colorDepth + "\n" + "connectionType = " + oClientCaps.connectionType + "\n" + "cookieEnabled = " + oClientCaps.cookieEnabled + "\n" + "cpuClass = " + oClientCaps.cpuClass + "\n" + "height = " + oClientCaps.height + "\n" + "javaEnabled = " + oClientCaps.javaEnabled + "\n" + "platform = " + oClientCaps.platform + "\n" + "systemLanguage = " + oClientCaps.systemLanguage + "\n" + "userLanguage = " + oClientCaps.userLanguage + "\n" + "width = " + oClientCaps.width + "\n" ; oPre.innerText = sTempStr; } </SCRIPT> </HEAD> <BODY> <H1>clientCaps Behavior Sample</H1> <P>This example shows how to use the new <B>clientCaps</B> behavior, introduced in Microsoft Internet Explorer 5, to obtain client capabilities information. The following is a sampling of the information that can be obtained:</P> <IE:CLIENTCAPS ID="oClientCaps" /> <PRE id="oPre"></PRE> </BODY> </HTML>This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
Standards Information
There is no public standard that applies to this property.
Applies To
clientCaps
See Also
About Client Capabilities