Join method
Collapse the table of content
Expand the table of content
The document is archived and information here might be outdated

Join method

Join method

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release. See also         Example Applies to

Creates a new shape by joining selected shapes.

Version added





Required. An expression that returns a Selection object containing the shapes to join.


The Join method is equivalent to clicking Join on the Operation submenu on the Shape menu in Visio. The new shape inherits the text and formatting of the first selected shape and is the topmost shape in its container—the nth shape in the Shapes collection of its containing shape, where n = Count.

The original shapes are deleted and no shapes are selected when the operation is complete.

The Join method and the Combine method are similar but differ in the following ways:

  • Join coalesces abutting line and curve segments in the original shapes into a single Geometry section in the resulting shape.
  • Combine produces a shape that has one Geometry section for each original shape. The resulting shape has holes in regions where the original shapes overlapped.

You might want to join shapes after importing a non-Visio drawing in which apparent polylines are represented by many independent shapes, each possessing a single line or curve segment. By joining the shapes that constitute a polyline in such a drawing, you can replace many single-segment shapes with one multiple-segment shape.

© 2016 Microsoft