uap:FileTypeAssociation (Windows 10)

Article
11/22/2023

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

<uap:Extension>

<uap:FileTypeAssociation>

Syntax

<uap:FileTypeAssociation
  Name = 'A string with a value between 1 and 100 characters in length.'
  DesiredView = 'An optional string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
  desktop2:UseUrl = 'An optional boolean value.'
  desktop2:AllowSilentDefaultTakeOver = 'An optional boolean value.' 
  desktop5:ThumbnailTypeOverlay = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot 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?
  & desktop7:Logo?
  & desktop7:ProgId?
  & desktop10:IconHandler?

</uap:FileTypeAssociation>

Key

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

Attributes and elements

Attributes

Attribute	Description	Data type	Required
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 with a value between 1 and 100 characters in length.	Yes
DesiredView	The desired amount of screen space to use when the app launches. This view mode preference is a requested value only. The preferred size that you specify is not guaranteed to be honored by Windows, so you should not write code that relies on never getting into a size that is smaller than the preferred minimum size or larger than the preferred maximum size.	An optional string that can have one of the following values: default, useLess, useHalf, useMore, or useMinimum.	No
desktop2:UseUrl	If set to true, specifies that the application can accept a URL, instead of a file name, on the command line. Applications that can open documents directly from the internet, like web browsers and media players, should use this value. When `ShellExecuteEx` starts an application and this value is set to false, the default behavior, `ShellExecuteEx` downloads the document to a local file and invokes the handler on the local copy.	An optional boolean value.	No
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.	An optional boolean value.	No
desktop5:ThumbnailTypeOverlay	An image resource for a thumbnail overlay.	A string with a value between 1 and 256 characters in length that ends with `.jpg`, `.png`, or `.jpeg` that cannot contain these characters: `<`, `>`, `:`, `"`, `\|`, `?`, or `*`. In this string, the `/` and `\` characters cannot 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	Contains programmatic identifier (ProgID) values that describe the application, component, and version of each desktop application from which you want to inherit file associations.
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.
desktop7:Logo	A path to a file that contains an image. Adds support for .ico file extensions.
desktop7:ProgId	A programmatic identifier (ProgID) that can be associated with a CLSID.
desktop10:IconHandler	Enables an IconHandler for a file type association.

Parent elements

Parent element	Description
uap:Extension	Declares an extensibility point for the app.

Requirements

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

Share via