Share via


bufferDepth Property

This topic documents a feature of Binary Behaviors, which are obsolete as of Internet Explorer 10.

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

Syntax

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

Possible Values

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

 New for Windows Internet Explorer 9 As of Internet Explorer 9, this property is deprecated. Applications that depend on this property should be redesigned.

Unsupported 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 <B>clientCaps</B> 
behavior, introduced in Microsoft Internet Explorer 5, to obtain 
client capabilities information. The following is a sample of the 
information that can be obtained.</P>

<IE:CLIENTCAPS ID="oClientCaps" />

<PRE id="oPre"></PRE>
</BODY>
</HTML>

Code example: https://samples.msdn.microsoft.com/workshop/samples/author/behaviors/clientCaps/ccProperties.htm

Applies To

clientCaps

See Also

About Client Capabilities