Share via

2.2.4.12 ST_UserInterfaceObjectEvent

  • Article

Target namespace: http://schemas.microsoft.com/office/accessservices/2010/12/application

Referenced by: CT_UserInterfaceMacro

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

The value MUST be one of the events that is supported by the form or by the type of control that is specified by the For attribute of the CT_UserInterfaceMacro (section 2.2.3.43) element.

The following table lists the valid events for form and control types. Any control types not listed have no valid events.

Control type

Valid events

Form

OnLoad, OnCurrent

Text Box / Multiline Textbox

OnClick, AfterUpdate

Button

OnClick

Combo Box

AfterUpdate

Label

OnClick

Image

OnClick

Autocomplete Control

OnClick, AfterUpdate

Check Box

AfterUpdate

Hyperlink Control

OnClick, AfterUpdate

The following table lists the meaning of each event.

Value

Meaning

OnClick

Call the macro after a control is clicked.

onclick

Call the macro after a control is clicked.

AfterUpdate

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

afterupdate

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

OnCurrent

Call the macro after the current record is changed.

oncurrent

Call the macro after the current record is changed.

OnLoad

Call the macro after a Form is loaded.

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="onclick" wbld:cname="onclick"/>
     <xsd:enumeration value="AfterUpdate" wbld:cname="AfterUpdate"/>
     <xsd:enumeration value="afterupdate" wbld:cname="afterupdate"/>
     <xsd:enumeration value="OnCurrent" wbld:cname="OnCurrent"/>
     <xsd:enumeration value="oncurrent" wbld:cname="oncurrent"/>
     <xsd:enumeration value="OnLoad" wbld:cname="OnLoad"/>
     <xsd:enumeration value="onload" wbld:cname="onload"/>
   </xsd:restriction>
 </xsd:simpleType>

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