BegTrigger Element [Visio 2003 SDK Documentation]

Article
05/01/2007

Contains a trigger formula generated by Microsoft Office Visio that determines whether to move the begin point of a 1-D shape to maintain its connection to another shape.

Syntax

<BegTrigger>
    [Unit]
    [F]
    [Err]>
</BegTrigger>

Attributes

Unit

Optional string. Represents a unit of measure. The default is NUM. For details about NUM, see Units of measure.

Optional string. Represents the element's formula. This attribute can contain the string "someFormula" if the formula exists locally, "No Formula" if the formula is locally deleted or blocked, or "Inh" if the formula is inherited.

If the attribute is not present, the element's formula is a simple constant, for example, <element>5</element>.

Err

Optional string. Indicates that the formula evaluates to an error. The value of Err is the current value (an error message string); the value of the element is the last valid value.

Element properties

Property	Value
Name	BegTrigger
Minimum Occurrences	0
Maximum Occurrences	1

Element information

Parent elements

Misc

Child elements

None

Remarks

When you glue a 1-D shape to another shape using dynamic glue, Visio generates a formula that refers to the EventXFMod element of the other shape. When that shape is changed, Visio recalculates any formula that refers to its EventXFMod element, including the formula in the BegTrigger element. Other formulas for the 1-D shape refer to the BegTrigger element and move the begin point of the 1-D shape or alter the shape as needed.

The BegTrigger element is relevant only when contained in a Shape or StyleSheet element. It is ignored when contained in a DocumentSheet or PageSheet element.