Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

clip property

Specifies which part of a positioned object is visible.

This property is read/write.

CSS 2.1, Section 11.1.2


HRESULT put_clip(
  BSTR v

HRESULT get_clip(
  [out, retval]  BSTR *sClip = auto

Property values

Type: BSTR

auto (auto)

Default. Clip to expose entire object.

rect(top, right, bottom, left) (rect(top, right, bottom, left))

Top, right, bottom, and left specify length values, any of which can be replaced by auto, leaving that side not clipped. The value of top specifies that everything above this value on the Y axis (with 0 at the top) is clipped. The value of right specifies that everything above this value on the X axis (with 0 at the left) is clipped. The value of bottom specifies that everything below this value on the Y axis (with 0 at the top) is clipped. The value of left specifies that everything to the left of this value on the X axis (with 0 at the left) is clipped.

String format

auto | rect(top, right, bottom, left)

CSS information

Applies Toabsolutely positioned elements
Initial Valueauto

Standards information


This property defines the shape and size of the positioned object that is visible. The IHTMLCSSStyleDeclaration::position must be set to absolute. Any part of the object that is outside the clipping region is transparent. Any coordinate can be replaced by the value auto, which exposes the respective side (that is, the side is not clipped).

The order of the values in "clip:rect(0, 0, 50, 50)" renders the object invisible because it sets the top and right positions of the clipping region to 0. To achieve a 50-by-50 view port, use "clip:rect(0, 50, 50, 0)".

Starting in Windows Internet Explorer 8, the required syntax of the IHTMLCSSStyleDeclaration::clip property is identical to that specified in the Cascading Style Sheets, Level 2 Revision 1 (CSS2.1) specification; that is, commas are now required between the parameters of the rect() value. This behavior requires Windows Internet Explorer to be in IE8 Standards mode or higher. For more information on document compatibility modes, see Defining Document Compatibility.

In Windows Internet Explorer 7 and earlier (and in Internet Explorer 8 or later in IE7 Standards mode, EmulateIE7 mode, or IE5 (Quirks) mode), the commas should be omitted. For example: "clip:rect(0 50 50 0)"


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]







See also




Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft. All rights reserved.