clip property

[This documentation is preliminary and is subject to change.]

Sets or retrieves which part of a positioned object is visible.

Syntax

Integer value = object.put_clip(BSTR v);Integer value = object.get_clip(BSTR* sClip);

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

Remarks

The required syntax of the clip attribute 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 property defines the shape and size of the positioned object that is visible. The 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 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).

The clip attribute and the clip property are available on the Macintosh platform, as of Microsoft Internet Explorer 5.

Requirements

See also

Reference

clipBottom

clipLeft

clipRight

clipTop

Build date: 1/23/2012