GlueToPos method

Microsoft Visio Developer Reference

GlueToPos method

       

Glues one shape to another from a cell in the first shape to an x,y position in the second shape.

Version added

2.0

Syntax

object.GlueToPos shpObject, x, y

object

Required. An expression that returns a Cell object.

shpObject

Required object. An expression that returns the Shape object to be glued to.

x

Required Double. The x-coordinate of the position to glue to.

y

Required Double. The y-coordinate of the position to glue to.

Remarks

The GlueToPos method creates a new connection point at the location determined by x and y, which represent decimal fractions of the specified shape's width and height, respectively, rather than coordinates. For example, the following creates a connection point at the center of shpObject and glues the part of the shape that celObj represents to that point:

celObj.GlueToPos shpObject, 0.5, 0.5

Gluing the X cell of a Controls section row or a BeginX or EndX cell automatically glues the Y cell of the Controls section row or the BeginY or EndY cell, respectively. (The reverse is also true.)