Clip Method

Clip Method (McLines)

Description

Clips a set of features to a given rectangle.

Return Type

None

Syntax

object.Clip Left, Top, Right, Bottom

The Clip Method syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McLines.
Left	Required. A Long value. the left side of the clipping rectangle
Top	Required. A Long value. the upper side of the clipping rectangle
Right	Required. A Long value. the right side of the clipping rectangle
Bottom	Required. A Long value. the lower side of the clipping rectangle

Remarks

After clipping, the resulting features are guaranteed to lie within the rectangle. If an McRegions has the mcofKeepRegionsAsUnion OptionFlags bit set, then if the sub-regions are completely outside the rectangle, the region is now empty. If the features were completely inside the rectangle, they are unchanged. The ChangeCounter property will be unchanged if no clipping occurs.

For McPoints type features, any points that fall outside of the given rectangle are removed. This may leave the set of points empty.

For an McLines or an McRegions with the mcofKeepRegionsAsUnion OptionFlags bit clear, if a line or region feature is completely outside of the clipping rectangle, then that feature is removed. This may leave the set of features empty (IsEmpty will be true).

Polylines that are not completely outside of the clipping rectangle are clipped to the rectangle bounds and adjacent duplicate points are condensed. Regions of type mcftEllipse will become type mcftOutline if the boundary is clipped.