Edit

Share via

uap:LaunchAction (in AppointmentsProviderLaunchActions)

  • Article

Describes an uap:AppointmentsProviderLaunchActions content action.

Element hierarchy

<Package>

    <Applications>

         <Application>

              <Extensions>

                   <uap:Extension>

                        <uap:AppointmentsProvider>

                             <uap:AppointmentsProviderLaunchActions>

                                  <uap:LaunchAction>

Syntax

<uap:LaunchAction
    EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (normally the fully namespace-qualified name of a Windows Runtime type). If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
    Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. Specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
    RuntimeType = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
    StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
    Verb = 'A string that can have any of the following values: "addAppointment", "removeAppointment", "replaceAppointment", "showTimeFrame", or "showAppointmentDetails".'
    DesiredView = 'A string that can have any of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".' />

Key

?   optional (zero or one)

Attributes and elements

Attributes

Attribute Description Data type Required Default value
EntryPoint The activatable class ID. A string with a value between 1 and 256 characters in length. Represents the task handling the extension (normally the fully namespace-qualified name of a Windows Runtime type). If EntryPoint is not specified, the EntryPoint defined for the app is used instead. No
Executable The default launch executable. A string with a value between 1 and 256 characters in length, that must end with .exe, and cannot contain these characters: <, >, :, ", |, ?, or *. Specifies the default executable for the extension. If not specified, the executable defined for the app is used. If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used. No
RuntimeType The runtime provider. Typically used when there are mixted frameworks in an app. A string with a value between 1 and 255 characters in length that cannot start or end with a . or contain there characters: <, >, :, ", |, ?, or *. No
StartPage The web page that handles the extensibility point. A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. No
ResourceGroup An optional tag used to group extension activations together for resource management purposes (for example, CPU and memory). See the Remarks section in Application@ResourceGroup. An alphanumeric string between 1 and 255 characters in length. Must begin with a letter. No
Verb A unique identifier that is passed to the app when it is launched. The app can use this string to determine which uap:AppointmentsProviderLaunchActions handler triggered its launch. It is unique per application in the package and is case sensitive. A string that can have any of the following values: addAppointment, removeAppointment, replaceAppointment, showTimeFrame, or showAppointmentDetails. No
DesiredView The desired amount of screen space to use when the appointment launches. A string that can have any of the following values: default, useLess, useHalf, useMore, or useMinimum. No

Child elements

None.

Parent elements

Parent element Description
uap:AppointmentsProviderLaunchActions Declares actions to take when a appointment is launched.

The following elements have the same name as this one, but different content or attributes:

Remarks

For more info about launch actions that an appointments provider takes, see AppointmentsProviderLaunchActionVerbs.

LaunchAction (in AppointmentsProviderLaunchActions) has these semantic validations:

  • Extension base attributes must follow these rules:

    • If the StartPage attribute is specified, fail if the EntryPoint, Executable, or RuntimeType attribute is specified.
    • Otherwise, fail if the Executable or RuntimeType attribute is specified without an EntryPoint specified.

  • If LaunchAction (in AppointmentsProviderLaunchActions) defines the EntryPoint attribute, either this LaunchAction (in AppointmentsProviderLaunchActions) or the parent uap:Extension or Application element must specify an Executable attribute.

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10
Minimum OS Version Windows 10 version 1511 (Build 10586)