Edit

LaunchEvent element

  • Article

Configures your add-in to activate based on supported events. Child of the LaunchEvents element. For more information, see Configure your Outlook add-in for event-based activation.

Add-in type: Mail

Valid only in these VersionOverrides schemas:

  • Mail 1.1

For more information, see Version overrides in the manifest.

Syntax

<ExtensionPoint xsi:type="LaunchEvent">
  <LaunchEvents>
    <LaunchEvent Type="OnNewMessageCompose" FunctionName="onMessageComposeHandler"/>
    <LaunchEvent Type="OnNewAppointmentOrganizer" FunctionName="onAppointmentComposeHandler"/>
    <LaunchEvent Type="OnMessageReadWithCustomHeader" FunctionName="onMessageReadWithCustomHeaderHandler" HeaderName="contoso-spam-simulation"/>
  </LaunchEvents>
  <!-- Identifies the runtime to be used (also referenced by the Runtime element). -->
  <SourceLocation resid="WebViewRuntime.Url"/>
</ExtensionPoint>

Contained in

Attributes

Attribute Required Description
Type Yes Specifies a supported event type. For the set of supported types, see Configure your Outlook add-in for event-based activation.
FunctionName Yes Specifies the name of the JavaScript function to handle the event specified in the Type attribute.
SendMode No Used by the OnMessageSend and OnAppointmentSend events. Specifies the options available to the user if your add-in stops an item from being sent or if the add-in is unavailable. If the SendMode property isn't included, the SoftBlock option is set by default. For a list of available send mode options, see Available send mode options.
HeaderName (preview) No Specifies the internet header name used to identify a message on which the OnMessageReadWithCustomHeader event occurs. The Type attribute must be set to OnMessageReadWithCustomHeader.

See also