entryMacro (Script Function to Execute on Form Field Entry)

This element specifies a subroutine in a scripting language which should be executed when the when the run contents of the parent form field are entered. The language and location of this subroutine may be determined using any method desired by an application. [Note: It is at the discretion of an application to determine the scope and timing of "entering" a form field, for example, when the user moves the insertion point in a user interface or upon each operation by an application without a user interface, etc. end note]

If this element is omitted, then no subroutine shall be associated with entering the run contents of the parent form field. If this element specifies a macro which cannot be located or is not supported by an application, then its value may be ignored, but shall not be lost upon resaving the file.

[Example: Consider the following WordprocessingML fragment for the properties of a checkbox form field:

<w:ffData>
<w:entryMacro w:val="TestEntryFunction" />
<w:checkBox>
…
</w:checkBox>
</w:ffData>

The entryMacro element specifies that any application which processes this file should attempt to locate and execute a scripting subroutine called TestEntryFunction when the contents of the checkbox are entered. If this subroutine cannot be located or executed, then this setting is silently ignored. end example]

Parent Elements

ffData (§2.16.17)

Attributes

Description

val (Name of Script Function)

Specifies the name of a single scripting subroutine which shall be associated with the parent element. Its use is specifies based on the context of the parent XML element.

[Example: Consider the following WordprocessingML fragment for the properties of a form field:

<w:ffData>
<w:exitMacro w:val="HelloWorld" />
</w:ffData>

The val attribute specifies that a script function called HelloWorld shall be used in the context of the parent element; in this case, to execute when the field is exited. end example]

The possible values for this attribute are defined by the ST_MacroName simple type (§2.18.58).

The following XML Schema fragment defines the contents of this element:

</complexType>