Share via

2.2.4.2 ST_UserInterfaceObjectEvent

  • Article

Target namespace: http://schemas.microsoft.com/office/accessservices/2009/11/application

Referenced by: CT_MacroReference, CT_UserInterfaceMacro

A string ([XMLSCHEMA2/2] section 3.2.1) that specifies the type of event that causes a Macro to be called.

For a CT_MacroReference or a CT_UserInterfaceMacro, the value MUST be one of the events that is supported by the form, if no For attribute is present, or by the type of control that is specified by the For attribute. Any control types not listed in the following table have no valid events.

OnDblClick MUST NOT be used in a CT_AccLabel if its Association attribute is present.

Control type

Valid events

CT_Form (no For attribute present)

OnLoad, OnCurrent

CT_AccTextBox

OnClick, AfterUpdate, OnDblClick

CT_AccButton

OnClick

CT_AccComboBox or CT_AccListBox

AfterUpdate, OnDblClick

CT_AccLabel

OnClick, OnDblClick

CT_AccImage

OnClick, OnDblClick

CT_AccAttachment

OnClick

CT_AccCheckBox

AfterUpdate

CT_AccTabControl

OnChange

Value

Meaning

OnClick

Call the macro after a control is clicked.

OnDblClick

Call the macro after a control is double-clicked.

AfterUpdate

Call the macro after the content of a control is updated.<4>

OnChange

Call the macro after the content of a control is changed.

OnCurrent

Call the macro after the current record is changed.

OnLoad

Call the macro after a Form is loaded.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

 <xsd:simpleType name="ST_UserInterfaceObjectEvent">
   <xsd:restriction base="xsd:string">
     <xsd:minLength value="1"/>
     <xsd:maxLength value="64"/>
     <xsd:enumeration value="OnClick" wbld:cname="OnClick"/>
     <xsd:enumeration value="OnDblClick" wbld:cname="OnDblClick"/>
     <xsd:enumeration value="AfterUpdate" wbld:cname="AfterUpdate"/>
     <xsd:enumeration value="OnChange" wbld:cname="OnChange"/>
     <xsd:enumeration value="OnCurrent" wbld:cname="OnCurrent"/>
     <xsd:enumeration value="OnLoad" wbld:cname="OnLoad"/>
   </xsd:restriction>
 </xsd:simpleType>

See section 5.4 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).