modgenReferencePoint

layoutXL modgenReferencePoint cyclic { "center" | "interactive" | "lowerLeft" | "upperRight" | "upperLeft" | "lowerRight" }

Description

Specifies the reference point for aligning Modgens when they are either created or repositioned, for example when a Modgen is moved or when the number of rows in a Modgen is increased. Valid values are:

• center – Aligns the center of the new or edited Modgen with the center of the existing Modgen.
• interactive – Aligns the center of the new or edited Modgen with the center of the existing Modgen. However, the center excludes any user-moved instance.
  Example:
  Instances in an existing Modgen are positioned as following:
  M1
M2 M3 M4
  Instance M1 is moved to the right of the three instances. The revised alignment of the Modgen is follows:
  M2 M3 M4 M1
  When set to center, all instances, M1 M2 M3 M4, are considered for determining the center of the Modgen.
  When set to interactive, only instances, M2 M3 M4, are considered.
• lowerLeft – Aligns the lower left corner of the new or edited Modgen with that of the existing Modgen.
• upperRight – Aligns the upper right corner of the new or edited Modgen with that of the existing Modgen.
• upperLeft – Aligns the upper left corner of the new or edited Modgen with that of the existing Modgen.
• lowerRight – Aligns the lower right corner of the new or edited Modgen with that of the existing Modgen.

The default is interactive.

GUI Equivalent

None

Examples

envGetVal("layoutXL" "modgenReferencePoint")

envSetVal("layoutXL" "modgenReferencePoint" 'cyclic "center")

envSetVal("layoutXL" "modgenReferencePoint" 'cyclic "lowerLeft")

Related Topics

Creating a Modgen

Modgen On-Canvas Commands

Return to top