paddingLeft property

Sets or retrieves the amount of space to insert between the left border of the object and the content.

Syntax

Integer value = object.put_paddingLeft(Variant v);Integer value = object.get_paddingLeft(Variant* sPadding);

Property values

Type: VARIANT

percentage (percentage)

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

String format

<length> | <percentage>

CSS information

Applies To All elements
Media visual
Inherited no
Initial Value 0

Standards information

Remarks

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.

Negative values are not allowed.

Examples

The following example shows two div elements that each contain text and have specified IHTMLCSSStyleDeclaration::width and IHTMLCSSStyleDeclaration::border values. The second div element also has a specified IHTMLCSSStyleDeclaration::paddingLeft value.

<div id="noPadding">
   <p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.</p>
</div>
<div id="paddingLeft">
   <p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.</p>
</div>
#noPadding {
   width: 200px;
   border: .5em solid #BBBBBB;
}
#paddingLeft {
   width: 200px;
   border: .5em solid #BBBBBB;
   padding-left: 20px;
}

The following image shows the first div element without any padding.

The following image shows the second div element with a IHTMLCSSStyleDeclaration::paddingLeft value of 20 pixels.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

CSS Enhancements in Internet Explorer 6