Trigger element (Visio XML)

Article
03/16/2022

Provides instructions to Microsoft Visio to recalculate a relationship between document parts in a Visio file.

Element information

	Value
Element type	Trigger_Type
Namespace	http://schemas.microsoft.com/office/visio/2012/main
Schema file	VisioSchema15.xsd
Document parts	master#.xml, page#.xml

Definition

<xs:element name="Trigger" type="Trigger_Type" minOccurs="0" maxOccurs="unbounded" >
</xs:element>

Elements and attributes

If the schema defines specific requirements, such as sequence, minOccurs, maxOccurs, and choice, see the definition section.

Parent elements

Element	Type	Description
Shape	ShapeSheet_Type	Specifies cell elements that provide information for the definition of a shape.
DocumentSheet	DocumentSheet_Type	Defines the DocumentSheet structure.
StyleSheet	StyleSheet_Type	Represents a style defined in a document.
PageSheet (Master_Type complexType)	PageSheet_Type	Specifies the properties of the drawing page associated with the master.
PageSheet (Page_Type complexType)	PageSheet_Type	Specifies the properties of the drawing page associated with the drawing page.

Child elements

Element	Type	Description
RefBy	RefBy_Type	Specifies a reference toa page in the drawing.

Attributes

Attribute	Type	Required	Description	Possible values
N	xsd:string	required	The name of the formula to be called when the trigger is activated. See the Remarks section.	Values of the xsd:string type.

Remarks

The N attribute of this Trigger element must be one of a limited set of values that correspond to trigger instructions. Refer to the table below to determine the values of the N attribute that are permitted for this Trigger element.

Value	Parent element	Description
CategoryChanged	PageSheet (Page_Type complexType)	A trigger that appears on a shape when a cross-part reference using a HASCATEGORIES function exists.
RecalcBkgPageName	PageSheet (Page_Type complexType)	A trigger that appears on a page when a cross-part reference using a BKGPAGENAME function exists
RecalcColor	PageSheet (Page_Type complexType)	A trigger that appears on a page whenever the page or any of its contained shapes uses a RGB function.
RecalcCreateDT	DocumentSheet	A trigger that appears on a document when a cross-part reference using a DOCCREATION function exists.
RecalcData1	Shape	A trigger that appears on a shape when a cross-part reference using a DATA1 function exists.
RecalcData2	Shape	A trigger that appears on a shape when a cross-part reference using a DATA2 function exists.
RecalcData3	Shape	A trigger that appears on a shape when a cross-part reference using a DATA3 function exists.
RecalcEditDT	DocumentSheet	A trigger that appears on a document when a cross-part reference using a DOCLASTEDIT function exists.
RecalcID	Shape	A trigger that appears on a shape when a cross-part reference using a ID function exists.
RecalcMasterName	Shape	A trigger that appears on a shape when a cross-part reference using a MASTERNAME function exists.
RecalcName	Shape	A trigger that appears on a shape when a cross-part reference using a NAME function exists.
RecalcNowAndRand	PageSheet (Page_Type complexType)	A trigger that appears on a page if either the page or any of its containing shapes have a NOW or a RAND function.
RecalcPageCount	DocumentSheet	A trigger that appears on a document when a cross-part reference using a PAGECOUNT function exists.
RecalcPageName	PageSheet (Page_Type complexType) Shape	A trigger that appears on a shape when a cross-part reference using a PAGENAME function exists.
RecalcPageNum	PageSheet (Page_Type complexType)	A trigger that appears on a page when a cross-part reference using a PAGENUMBER function exists.
RecalcPath	DocumentSheet	A trigger that appears on a shape when a cross-part reference using a POINTALONGPATH, PATHLENGTH, or PATHSEGMENT function exists.
RecalcPrintDT	DocumentSheet	A trigger that appears on a document when a cross-part reference using a DOCLASTPRINT function exists.
RecalcSaveDT	DocumentSheet	A trigger that appears on a document when a cross-part reference using a DOCLASTSAVE function exists.
RecalcSummary	DocumentSheet	A trigger that appears on a document when a cross-part reference using a CATEGORY, CREATOR, DESCRIPTION, KEYWORDS, SUBJECT, or TITLE function exists.
RecalcType	Shape	A trigger that appears on a shape when a cross-part reference using a TYPE function exists.
RelChanged	Shape	A trigger that appears on a shape when a cross-part reference using a CONTAINERMEMBERCOUNT function exists.
ZOrderChanged	PageSheet (Page_Type complexType)	A trigger that appears on a page when a cross-part reference using a CONTAINERSHEETREF function exists.
Path	Shape	A trigger that appears on a page when a cross-part reference using a POINTALONGPATH, PATHLENGTH, or PATHSEGMENT function exists.