Sets or retrieves which part of a positioned object is visible.
HRESULT IHTMLCSSStyleDeclaration::get_clip(BSTR *p);HRESULT IHTMLCSSStyleDeclaration::put_clip(BSTR v);
- Pointer to a variable of type BSTR that receives one of the values listed in Possible Values.
- BSTR that specifies one of the values listed in Possible Values.
auto Default. Clip to expose entire object. 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.
Returns S_OK if successful, or an error value otherwise.
As of Internet Explorer 8, the required syntax of the clip attribute is identical to that specified in the Cascading Style Sheets (CSS), Level 2 Revision 1 (CSS2.1) specification; that is, commas are now required between the parameters of the
rect()value. This behavior requires Internet Explorer to be in IE8 Standards mode (or EmulateIE8 mode with an Internet Explorer 8 !DOCTYPE directive). For more information on document compatibility modes, see Defining Document Compatibility.
In 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: IHTMLCSSStyleDeclaration::clip:
rect(0 50 50 0)
The required syntax of the clip attribute is identical to that specified in the CSS2.1 specification; that is, commas are now required between the parameters of the
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 IHTMLCSSStyleDeclaration::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 IHTMLCSSStyleDeclaration::clip:
rect(0, 50, 50, 0).
The IHTMLCSSStyleDeclaration::clip attribute and the IHTMLCSSStyleDeclaration::clip property are available on the Macintosh platform, as of Microsoft Internet Explorer 5.