bufferDepth

HTML (DHTML)

bufferDepth Property

Internet Development Index

Retrieves the number of bits per pixel used for colors on the off-screen bitmap buffer.

Syntax

XMLN/A
Scripting[ iBitsPerPixel = ] clientCaps.bufferDepth

Possible Values

iBitsPerPixelInteger that receives one of the following values:
0Default. No explicit buffering occurs. The colorDepth property is set to the screen depth.
-1Buffering occurs at the screen depth. The colorDepth property is set to the screen depth.
1, 4, 8, 15, 16, 24, 32Off-screen buffering occurs based on the specified number of bits per pixel. The colorDepth property is also set to this value. 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 a default value of 0.

Remarks

Nonsupported values cause bufferDepth to be set to -1.

When bufferDepth is -1 and the user changes system settings that affect the screen depth, the buffer depth automatically updates to the new depth. This does not occur if bufferDepth is set to a specific value.

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