Combine method

Microsoft Visio Developer Reference

Combine method

   Example   

Creates a new shape by combining selected shapes.

Version added

2.0

Syntax

object.Combine

object

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

Remarks

The Combine method is equivalent to clicking the Combine command on the Operations submenu on the Shape menu in 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.