EventItem Element

Encapsulates an event code.

An EventItem element can trigger two kinds of actions: it can run an add-on, or it can send a notification of the event to the calling program.

Syntax


<EventItem
    ID
    Action
    EventCode    
    Target
    TargetArgs
    [Enabled]>
</EventItem>

Attributes

ID

Required int. The ID of the event.

Action

Required int. Specifies the action code of the parent EventItem element.

For an EventItem element to be saved in a DatadiagramML file, it must be persistable. Currently, the only valid action code a persistable event can have is 1 (ONEVENT_ACT_RUNADDON).

EventCode

Required int. A code indicating the event that triggers the add-on. For more information on event codes, see Event codes in the Microsoft Office Visio 2003 Automation Reference.

Target

Required string. Specifies the target of an event.

TargetArgs

Required string. Specifies a string containing arguments to be sent to the target of an event.

Enabled

Optional boolean. Represents a flag indicating if the event is enabled or disabled.

ValueDescription
0The event is disabled.
1The event is enabled.

Element properties

PropertyValue
NameEventItem
Minimum Occurrences0
Maximum OccurrencesUnbounded

Element information

Parent elements

EventList

Child elements

None

See also

Event object

©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp