Table of contents
TOC
Collapse the table of content
Expand the table of content

Shape.GluedShapes Method (Visio)

office 365 dev account|Last Updated: 6/12/2017
|
1 Contributor

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

NameRequired/OptionalData TypeDescription
FlagsRequiredVisGluedShapesFlagsThe dimensionality and directionality of the connection points of the shapes to return.
CategoryFilterRequiredStringThe category of shapes to return. See Remarks for more information
pOtherConnectedShapeOptionalShapeAdditional shape to which returned shapes must also be glued.

Return Value

Long()

Remarks

Flags must be one of the following VisGluedShapesFlags constants.

ConstantValueDescription
visGluedShapesAll1D0Return all 1-D shapes that are glued to this shape.
visGluedShapesIncoming1D1Return 1-D shapes whose end points are glued to this shape.
visGluedShapesOutgoing1D2Return 1-D shapes whose begin points are glued to this shape.
visGluedShapesAll2D3Return all 2-D shapes that are glued to this shape and all 2-D shapes to which this shape is glued.
visGluedShapesIncoming2D4If the source object is a 1-D shape, return the 2-D shape to which the begin point is glued. If the source object is a 2-D shape, return the 2-D shapes that are glued to this shape.
visGluedShapesOutgoing2D5If the source object is a 1-D shape, return the 2-D shape to which the end point is glued. If the source object is a 2-D shape, return the 2-D 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.

© 2018 Microsoft