offscreenBuffering property

  • Article

Sets or retrieves whether objects are drawn offscreen before being made visible to the user.

Syntax

HRESULT value = object.put_offscreenBuffering( v);HRESULT value = object.get_offscreenBuffering(* p);

Property values

Type: VARIANT_BOOL

auto

Default. BSTR that allows Internet Explorer to decide when offscreen buffering is used.

VARIANT_TRUE (true)

BOOL that enables offscreen buffering.

VARIANT_FALSE (false)

BOOL that disables offscreen buffering.

Remarks

The value of the IHTMLWindow2::offscreenBuffering property determines how the current document is drawn. When the property is set to true, objects are added to an offscreen buffer. After all objects are drawn, the contents of the offscreen buffer are made visible to the user. When the property is set to false, objects are rendered directly to the screen.

By default, Internet Explorer decides when to buffer objects offscreen. In addition, Internet Explorer automatically enables offscreen buffering when Microsoft DirectX-based components are used on the document.