Shape.GluedShapes method (Visio)

Returns an array that contains the identifiers of the shapes that are glued to a shape.

Syntax

expression. GluedShapes( _Flags_ , _CategoryFilter_ , _pOtherConnectedShape_ )

expression A variable that represents a Shape object.

Parameters

Name Required/Optional Data type Description
Flags Required VisGluedShapesFlags The dimensionality and directionality of the connection points of the shapes to return.
CategoryFilter Required String The category of shapes to return. See Remarks for more information
pOtherConnectedShape Optional Shape Additional shape to which returned shapes must also be glued.

Return value

Long()

Remarks

Flags must be one of the following VisGluedShapesFlags constants.

Constant Value Description
visGluedShapesAll1D 0 Return all 1D shapes that are glued to this shape.
visGluedShapesIncoming1D 1 Return 1D shapes whose end points are glued to this shape.
visGluedShapesOutgoing1D 2 Return 1D shapes whose begin points are glued to this shape.
visGluedShapesAll2D 3 Return all 2D shapes that are glued to this shape and all 2D shapes to which this shape is glued.
visGluedShapesIncoming2D 4 If the source object is a 1D shape, return the 2D shape to which the begin point is glued. If the source object is a 2D shape, return the 2D shapes that are glued to this shape.
visGluedShapesOutgoing2D 5 If the source object is a 1D shape, return the 2D shape to which the end point is glued. If the source object is a 2D shape, return the 2D shapes to which this shape is glued.

Categories are user-defined strings that you can use to categorize shapes and thereby to restrict membership in a container. You can define categories in the User.msvShapeCategories cell in the ShapeSheet for a shape. You can define multiple categories for a shape by separating those categories with semi-colons.

Connection points with dual directionality (both inward and outward) are identified as incoming or outgoing based on the way that they are used in a particular connection.

The GluedShapes method fails if the source object is a part of a master or a guide. Guides are excluded from any list of shapes returned.

If you specify an invalid shape for pOtherConnectedShape , Microsoft Visio returns an Invalid Parameter error.

GluedShapes returns an empty array if there are no qualifying shapes to return.

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.