minHeight property

Specifies the minimum height for an element.

 

Syntax

HRESULT value = object.put_minHeight( v);HRESULT value = object.get_minHeight(* p);

Property values

Type: VARIANT

The minimum height for an element.

length (length)

Floating-point number followed by an absolute units designator (cm, mm, in, pt, or pc) or a relative units designator (em, ex, or px). For more information about the supported length units, see CSS Values and Units Reference.

percentage (percentage)

Integer followed by a percent sign (%) that specifies a percentage of the containing block height to use as the minimum height of the element. If the height of the containing block is not explicitly set, then the element has no minimum height and the IHTMLCSSStyleDeclaration::minHeight property is interpreted as 0%. For Internet Explorer 6, information on containing blocks and how the height is computed, see the Cascading Style Sheets, Level 2 (CSS2) specification. For Internet Explorer 7, see the Cascading Style Sheets, Level 2.1 (CSS2.1) specification.

String format

auto | <length> | <percentage>

CSS information

Applies To All elements
Media visual
Inherited no
Initial Value auto

Standards information

Remarks

Internet Explorer for Windows Developer Preview introduces the 'auto' value as the initial value for IHTMLCSSStyleDeclaration::minHeight. This provides a reasonable default minimum size for flex items (for more information, see Flexible box layout).

In Internet Explorer 6, this property applies only to td, th, and tr elements in fixed-layout tables. To create a fixed-layout table, set the IHTMLCSSStyleDeclaration::tableLayout property of a table element to fixed. The advantage of a fixed-layout table is that it renders faster than an auto-layout table. Auto-layout tables are the default.

In Internet Explorer 7, the IHTMLCSSStyleDeclaration::minHeight/IHTMLCSSStyleDeclaration::maxHeight attributes apply to floating and absolutely positioned block, inline-block elements, and some intrinsic controls. They do not apply to non-replaced inline elements, such as table columns and row/column groups. (A "replaced" element has intrinsic dimensions, such as an img or textArea.)

In Internet Explorer 7, this property is enabled only under the strict !DOCTYPE.

Examples

The following example shows how the IHTMLCSSStyleDeclaration::minHeight and IHTMLCSSStyleDeclaration::maxHeight properties affect the layout of a div element.

body {
   background-color: #E3E3E3;
}
#one {
   background-color: #FFF;
   width: 200px;
   max-height: 100px;
}
#two {
   background-color: #FFF;
   width: 200px;
   min-height: 300px
}

The first div will never grow more than 100px in height because IHTMLCSSStyleDeclaration::maxHeight is set to 100px. The content does not fit in the div, so it continues beyond it.

The height of the second div is always at least 300px because IHTMLCSSStyleDeclaration::minHeight is set to 300px. In this example, the content does not fill the div.

<div id="one">
   <h3>max-height: 100px;</h3>
   Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
</div>
<div id="two" >
   <h3>min-height: 300px;</h3>
   Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
</div>

You can see the result below.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

Reference

IHTMLEmbedElement::height

Other Resources

Cascading Style Sheet Compatibility in Internet Explorer 7

CSS Enhancements in Internet Explorer 6