overflowY property

Article
05/02/2017

Sets or retrieves how to manage the content of the object when the content exceeds the height of the object.

Syntax

Integer value = object.put_overflowY( v);Integer value = object.get_overflowY(* sOverflow);

Property values

Type: BSTR

visible (visible)

Default. Content is not clipped and scroll bars are not added. Elements are clipped to the size of the containing window or frame.

scroll (scroll)

Content is clipped and scroll bars are added, even if the content does not exceed the dimensions of the object.

hidden (hidden)

Content that exceeds the dimensions of the object is not shown.

auto (auto)

Content is clipped and scrolling is added only when necessary.

String format

visible | scroll | hidden | auto

CSS information

Applies To	All elements
Media	visual
Inherited	no
Initial Value	visible

Standards information

There are no standards that apply here.

Remarks

Windows Internet Explorer 8. The -ms-overflow-y attribute is an extension to CSS, and can be used as a synonym for IHTMLCurrentStyle::overflowY in IE8 Standards mode.

With Microsoft Internet Explorer 6 and later, when you use the !DOCTYPE declaration to specify standards-compliant mode, this property applies to the html object.

Examples

This example shows two div elements that each contain text. In the first div element, the IHTMLCurrentStyle::overflowY property is set to visible. In the second div element, the IHTMLCurrentStyle::overflowY property is set to hidden.

 div {
  width: 150px;
  height: 150px;
  border-style: solid;
  border-width: thin;
  font-family: sans-serif;
  float: left;
  margin-right: 10px;
}
.of_visible {
  overflow-y: visible;
}
.of_hidden {
  overflow-y: hidden;
}

<body>
  <div class="of_visible">
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
  </div> 
  <div class="of_hidden">
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
  </div> 
</body>

The following images show the result. In the first div element, content is not clipped and scroll bars are not added:

In the second div element, content is clipped and scroll bars are not added:

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows 2000 Server
Header	Mshtml.h
IDL	Mshtml.idl
DLL	Mshtml.dll