uap:FileTypeAssociation (Windows 10)

Declares an app extensibility point of type windows.fileTypeAssociation. A file type association indicates that the app is registered to handle files of the specified types.

Element hierarchy

<Package>
<Applications>
<Application>
<Extensions>
<uap:Extension>
<uap:FileTypeAssociation>

Syntax

<FileTypeAssociation  Name         = A string between 1 and 100 characters in length.
                      DesiredView? = "default" | "useLess" | "useHalf" | "useMore" | "useMinimum" 
                      desktop2:UseUrl? = boolean.
                      desktop2:AllowSilentDefaultTakeOver? = boolean 
                      desktop5:ThumbnailTypeOverlay = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both. >

  <!-- Child elements -->
  ( uap:DisplayName?
  & uap:Logo?
  & uap:InfoTip?
  & uap:EditFlags?
  & uap:SupportedFileTypes?
  & uap2:SupportedVerbs?
  & uap4:KindMap?
  & rescap3:MigrationProgIds?
  & desktop2:ThumbnailHandler?
  & desktop2:OleClass?
  & desktop2:DesktopPreviewHandler?
  & desktop2:DesktopPropertyHandler?
  & desktop3:PropertyLists?
  )

</uap:FileTypeAssociation>

Key

?   optional (zero or one) &   interleave connector (may occur in any order)

Attributes and Elements

Attributes

Attribute Description Data type Required Default value
DesiredView

The desired amount of screen space to use when the appointment launches.

This attribute can have one of the following values:

  • default
  • useLess
  • useHalf
  • useMore
  • useMinimum
No
Name

The name of the file type association. You can use this name to organize and group file types. The name must be all lower case characters with no spaces.

A string between 1 and 100 characters in length. Yes
desktop2:AllowSilentDefaultTakeOver

If set to true, the app will appear in an "Open With" list, but it won't be the default app for the file type.

Boolean. No
desktop2:UseUrl

If set to true, the file will be opened with the URL path directly.

Boolean. No
desktop5:ThumbnailTypeOverlay

An image resource for a thumbnail overlay.

A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both. No

 

Child Elements

Child Element Description
uap:DisplayName

A friendly name that can be displayed to users.

uap:EditFlags

Specifies the type of info the user sees when opening a file associated to the extensibility point.

uap:InfoTip

Defines a string that provides additional info to the user about the file type.

uap:Logo

A path to a file that contains an image.

uap:SupportedFileTypes (type: CT_FTASupportedFileTypes)

Defines the file types associated with the app. They are unique per package and are case sensitive.

uap2:SupportedVerbs

Contains verbs for a file context menu.

uap4:KindMap

Specifies what Kind is and how it's used.

rescap3:MigrationProgIds

TODO

desktop2:ThumbnailHandler

Enables a ThumbnailProvider for a file type association.

desktop2:OleClass

Enables OLE to get the OLE class registered for a given file extension.

desktop2:DesktopPreviewHandler

Enables declaration of a preview handler for a file type association.

desktop2:DesktopPropertyHandler

Enables declaration of a property handler for a file type association.

desktop3:PropertyLists

Contains a list of properties to show under the properties tab of a file.

Parent Elements

Parent Element Description
uap:Extension

Declares an extensibility point for the app.

 

Requirements

Namespace

http://schemas.microsoft.com/appx/manifest/uap/windows10