top
Expand Minimize

backgroundClip property

Specifies the background painting area or areas relative to the element's bounding boxes.

CSS Backgrounds and Borders Module Level 3, Section 3.7Internet Explorer 9

Syntax

Integer value = object.put_backgroundClip( v);Integer value = object.get_backgroundClip(* sClip);

Property values

Type: BSTR

border-box (border-box)

Initial value. The background is painted within (clipped to) the border box.

padding-box (padding-box)

The background is painted within (clipped to) the padding box.

content-box (content-box)

The background is painted within (clipped to) the content box.

String format

border-box | padding-box | content-box [ , border-box | padding-box | content-box ]*

CSS information

Applies ToAll elements
Mediavisual
Inheritedno
Initial Valueborder-box

Standards information

Remarks

If the IHTMLCSSStyleDeclaration::backgroundAttachment property value for an element is set to "fixed", the IHTMLCSSStyleDeclaration::backgroundClip property has no effect.

Starting in Windows Internet Explorer 9, the background of an element can have multiple layers. The number of layers is determined by the number of comma-separated values in the IHTMLCSSStyleDeclaration::backgroundImage property. Each of the images is sized, positioned, and tiled according to the corresponding value in the other background properties (IHTMLCSSStyleDeclaration::backgroundAttachment, IHTMLCSSStyleDeclaration::backgroundClip, IHTMLCSSStyleDeclaration::backgroundOrigin, IHTMLCSSStyleDeclaration::backgroundPosition, IHTMLCSSStyleDeclaration::backgroundRepeat, and IHTMLCSSStyleDeclaration::backgroundSize). The first image in the list is the layer closest to the user, the next one is painted behind the first, and so on.

Requirements

Minimum supported client

Windows Vista with SP1, Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

Reference
IHTMLCSSStyleDeclaration::backgroundColor
IHTMLCSSStyleDeclaration::backgroundImage
IHTMLCSSStyleDeclaration::backgroundRepeat
IHTMLCSSStyleDeclaration::backgroundAttachment
IHTMLCSSStyleDeclaration::backgroundPosition
IHTMLCSSStyleDeclaration::backgroundOrigin
IHTMLCSSStyleDeclaration::backgroundSize
IHTMLCSSStyleDeclaration::background

 

 

Community Additions

ADD
Show:
© 2014 Microsoft