Share via

Combine Method [Visio 2003 SDK Documentation]

  • Article

Creates a new shape by combining selected shapes.

object**.Combine**

object     Required. An expression that returns the Selection object that contains the shapes to combine.

Version added

2.0

Remarks

Calling the Combine method is equivalent to clicking the Combine command on the Operations submenu of the Shape menu in Microsoft Office Visio. The produced shape will be the topmost shape in its containing shape and will inherit the text and formatting of the first selected shape. The original shapes are deleted and no shapes are selected when the operation is complete.

The Combine method is similar to the Join method but differs in the following ways:

  • The Combine method produces a shape with one Geometry section for each original shape. The resulting shape will have holes in regions where the original shapes overlapped.
  • The Join method differs from Combine in that it will coalesce abutting line and curve segments in the original shapes into a single Geometry section in the resulting shape.

Applies to | Selection object

See Also | ContainingShape property | Intersect method | Join method | Subtract method | Trim method | Union method