GlueTo method

  • Article

GlueTo 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

Glues one shape to another, from a cell in the first shape to a cell in the second shape.

Version added

2.0

Syntax

        
          object.GlueTogluetocell

object

Required. An expression that returns a Cell object.

gluetocell

Required. An expression that returns a Cell object that represents the part of the shape to glue to.

Remarks

Following is a list of possible connections.

  • A connection point cell.
  • A cell of a guide or guide point: When the begin or end cell of a 1-D shape is glued to a cell of a guide or guide point, two connections are created—one from the BeginX or EndX cell to the guide's Angle cell, and one from the BeginY or EndY cell to the guide's Angle cell.
  • The pin of a 2-D shape (creates dynamic glue): The shape being glued from must be routable ( ObjType includes visLOFlagsRoutable) or have a dynamic glue type ( GlueType includes visGlueTypeWalking), and does not prohibit dynamic glue (GlueType does not include visGlueTypeNoWalking). Gluing to PinX creates dynamic glue with a horizontal walking preference and gluing to PinY creates dynamic glue with a vertical walking preference.
  • Any cell of a vertex row in a Geometry section: A connection point is created that is glued to. Either the begin or end cell can be designated as the cell to glue from. The GlueTo method establishes new formulas in both the X and Y cells of the connection row.
  • The begin or end cell of a 1-D shape: A connection point is created that is glued to. Either the begin or end cell can be designated as the cell to glue from. The GlueTo method establishes new formulas in both the X and Y cells of the connection row.
  • The edge (a cell in the Alignment section) of a 2-D shape: A connection point is created that is glued to. Either the begin or end cell can be designated as the cell to glue from. The GlueTo method establishes new formulas in both the X and Y cells of the connection row.

A cell of a guide or guide point.

An inward or inward/outward connection point cell that is not a cell of a guide or guide point: When these cells are glued, two connections are created—one from the BeginX cell of the 1-D shape to the Connections.Xi cell, and the other from the EndX cell of the 1-D shape to the Connections.Yi cell.

An inward or inward/outward type connection point cell that is not a cell of a guide or guide point: If the outward connection point has a direction, then two connection points are created—one from the Angle cell to the Connections.Xi cell and the other from the PinX cell to the Connections.Yi cell.

  • A connection point cell.
  • A cell of a guide or guide point: When a control point is glued to a cell of a guide or guide point other than a connection point cell, two connections are created—one to the guide's PinX and one to the guide's PinY.
  • Any cell of a vertex row in a Geometry section: A connection point is created that is glued to. Any cell in the control point row can be designated as the cell to glue from. The GlueTo method establishes new formulas in both the X and Y cells of the connection row.
  • The begin or end cell of a 1-D shape that isn't a guide or guide point: A connection point is created that is glued to. Any cell in the control point row can be designated as the cell to glue from. The GlueTo method establishes new formulas in both the X and Y cells of the connection row.
  • The edge (a cell in the Alignment section) of a 2-D shape: A connection point is created that is glued to. Any cell in the control point row can be designated as the cell to glue from. The GlueTo method establishes new formulas in both the X and Y cells of the connection row.

For details about connection point type and direction, see the Connection Points section.