colorDepth

HTML (DHTML)

previous page next page

colorDepth Property

Retrieves the number of bits per pixel used for colors on the destination device or buffer.

Syntax

XML N/A
Scripting [ iBitsPerPixel = ] clientCaps.colorDepth

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