uap:FileTypeAssociation (Windows 10)

Статья
03/23/2023

Объявляет точку расширяемости приложения типа windows.fileTypeAssociation. Сопоставление типов файлов указывает, что приложение зарегистрировано для обработки файлов указанных типов.

Иерархия элементов

<uap:FileTypeAssociation>

Синтаксис

<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>

Ключ

? необязательный (ноль или один) & соединитель чередуемого взаимодействия (может возникать в любом порядке)

Элементы и атрибуты

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
имя;	Название сопоставления типов файлов. Это название можно использовать, чтобы упорядочить и сгруппировать типы файлов. Название должно состоять полностью из букв в нижнем регистре без пробелов.	Строка со значением от 1 до 100 символов в длину.	Да
DesiredView	Требуемый объем экранного пространства, используемого при запуске приложения. Этот режим представления является только запрошенным значением. Windows не гарантирует соблюдение предпочтительного размера, поэтому не следует писать код, который зависит от того, чтобы никогда не попасть в размер, который меньше предпочтительного минимального размера или больше предпочтительного максимального размера.	Необязательная строка, которая может иметь одно из следующих значений: default, useLess, useHalf, useMore или useMinimum.	Нет
desktop2:UseUrl	Если задано значение true, указывает, что приложение может принимать URL-адрес вместо имени файла в командной строке. Приложения, которые могут открывать документы непосредственно из Интернета, например веб-браузеры и проигрыватели мультимедиа, должны использовать это значение. Когда `ShellExecuteEx` приложение запускается и для этого значения задано значение false, по `ShellExecuteEx` умолчанию документ загружается в локальный файл и вызывается обработчик для локальной копии.	Необязательное логическое значение.	Нет
desktop2:AllowSilentDefaultTakeOver	Если задано значение true, приложение будет отображаться в списке "Открыть с помощью", но оно не будет приложением по умолчанию для типа файла.	Необязательное логическое значение.	Нет
desktop5:ThumbnailTypeOverlay	Ресурс изображения для наложения эскизов.	Строка со значением от 1 до 256 символов, заканчивающаяся `.jpg`на , `.png`или `.jpeg` , которая не может содержать следующие символы: `<`, `>`, `:`, `"`, `\|`, `?`или `*`. В этой строке `/` символы и `\` не могут быть первыми или последними символами. Кроме того, строка может содержать `/` или `\` , но не одновременно.	Нет

Дочерние элементы

Дочерний элемент	Описание
uap:DisplayName	Понятное имя, которое может отображаться для пользователей.
uap:EditFlags	Указывает тип сведений, которые пользователь видит при открытии файла, связанного с точкой расширяемости.
uap:InfoTip	Определяет строку, которая предоставляет пользователю дополнительные сведения о типе файла.
uap:Logo	Путь к файлу, который содержит изображение.
uap:SupportedFileTypes (тип: CT_FTASupportedFileTypes)	Определяет типы файлов, связанные с приложением. Они уникальны для каждого пакета и чувствительны к регистру.
uap2:SupportedVerbs	Содержит команды для контекстного меню файла.
uap4:KindMap	Указывает, что такое Тип и как он используется.
rescap3:MigrationProgIds	Содержит значения программного идентификатора (ProgID), описывающие приложение, компонент и версию каждого классического приложения, от которого требуется наследовать сопоставления файлов.
desktop2:ThumbnailHandler	Включает ThumbnailProvider для сопоставления типов файлов.
desktop2:OleClass	Позволяет OLE получить класс OLE, зарегистрированный для заданного расширения файла.
desktop2:DesktopPreviewHandler	Включает объявление обработчика предварительного просмотра для сопоставления типов файлов.
desktop2:DesktopPropertyHandler	Включает объявление обработчика свойств для сопоставления типов файлов.
desktop3:PropertyLists	Содержит список свойств для отображения на вкладке свойств файла.
desktop7:Logo	Путь к файлу, который содержит изображение. Добавлена поддержка расширений файлов ICO.
desktop7:ProgId	Программный идентификатор (ProgID), который можно связать с CLSID.
desktop10:IconHandler	Включает IconHandler для сопоставления типов файлов.

Родительские элементы

Родительский элемент	Описание
uap:Extension	Объявляет точку расширяемости для приложения.

Требования

Элемент	Значение
Пространство имен	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Minimum OS Version	Windows 10 версии 1511 (сборка 10586)