marginBottom property

Sets or retrieves the height of the bottom margin of the object.

 

Syntax

Integer value = object.put_marginBottom(Variant v);Integer value = object.get_marginBottom(Variant* sHeight);

Property values

Type: VARIANT

auto (auto)

Default. Bottom margin is set equal to the top margin.

percentage (percentage)

Integer, followed by a percent sign (%). The value is a percentage of the height of the parent object.

String format

<margin-width> | inherit

CSS information

Applies To All elements
Media visual
Inherited no
Initial Value 0

Standards information

Remarks

As of Microsoft Internet Explorer 4.0 or later, you can specify possible length values relative to the height of the element's font (em) or the height of the letter "x" (ex).

In Microsoft Internet Explorer 3.0, the specified margin value is added to the default value of the object. In Internet Explorer 4.0 or later, the margin value is absolute. The margin properties do not work with the td and tr objects in Internet Explorer 4.0, but they do work in Internet Explorer 3.0. To set margins in the cell for Internet Explorer 4.0 or later, apply the margin to an object, such as div or p, within the td.

As of Microsoft Internet Explorer 5.5, this property applies to inline elements. With earlier versions of Windows Internet Explorer, inline elements must have an absolute IHTMLCSSStyleDeclaration::position or layout to use this property. Element layout is set by providing a value for the IHTMLCSSStyleDeclaration::height property or the IHTMLCSSStyleDeclaration::width property.

For inline elements, the value of this property is used to compute the border area of a surrounding inline element, if present. This value does not contribute to the height of a line.

Negative margins are supported, except for top and bottom margins on inline objects.

Examples

In the following example, three div elements specify IHTMLCSSStyleDeclaration::height, IHTMLCSSStyleDeclaration::width, and IHTMLCSSStyleDeclaration::backgroundColor values. The second div element also specifies a IHTMLCSSStyleDeclaration::marginBottom value of 10px.

<div id="blue"></div>
<div id="yellow"></div>
<div id="green"></div>
#blue {
   background-color: #00A4EF;
   height: 50px;
   width: 50px;
}
#yellow {
   background-color: #FFB900;
   height: 50px;
   width: 50px;
   margin-bottom: 10px;
}
#green {
   background-color: #7FBA00;
   height: 50px;
   width: 50px;
}

The following image shows the result. The second div element has a bottom margin of 10 pixels.

The following example uses inline scripting to set the bottom margin of the image to 1 centimeter when an HTMLFrameSiteEvents::onmouseover event occurs.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/marginBottom.htm

<!DOCTYPE html>
<html>
<head>
  <title>marginBottom</title>
</head>

<body>
  <p>
    Mouseover the sphere to expand its bottom margin to 1cm.
    Mouseout to return to the default bottom margin.
  </p>

  <!-- WE USE IN-LINE SCRIPTING TO HANDLE MOUSE EVENTS: -->
  <div style="border: 1px dashed red; width: 80px;">
    <img src="http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/graphics/sphere.jpg"
      onmouseover="this.style.marginBottom='1cm'"
      onmouseout="this.style.marginBottom=''" />
  </div>
</body>
</html>

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

Conceptual

CSS Values and Units Reference

Other Resources

CSS Enhancements in Internet Explorer 6