Share via


EventDrop Element

Visio XML Reference

An event element that is evaluated when a shape is dropped on the drawing page, either as an instance or when a shape is duplicated or pasted.

Syntax

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

Attributes

Unit

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

F

Optional string. Represents the element's formula. This attribute can contain one of the following strings: "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 EventDrop
Minimum Occurrences 0
Maximum Occurrences 1

Element information

Parent elements

Event

Child elements

None

Remarks

Event elements are evaluated only when the event occurs, not upon formula entry.

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

Example

In the following example, the formula in the EventDrop element displays the Custom Properties dialog box when the shape is dropped on the drawing page, then sets its own formula to 0.

XML
  <Event>
  <TheData F="No Formula">0</TheData> 
  <TheText F="No Formula">0</TheText> 
  <EventDblClick F="_DefaultEvent()">0</EventDblClick> 
  <EventXFMod F="No Formula">0</EventXFMod> 
  <EventDrop F="DoCmd(1312)+SetF("eventdrop",0)">0</EventDrop> 
</Event>

See also

EventDrop cell (Events section)