uap:FileTypeAssociation (Windows 10)

Artikel
11/22/2023

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileTypeAssociation. Eine Dateitypzuordnung gibt an, dass die App registriert ist, um Dateien der angegebenen Typen zu verarbeiten.

Elementhierarchie

<Paket>

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

Schlüssel

? optionaler (null oder eins) & interleave Connector (kann in beliebiger Reihenfolge auftreten)

Attribute und Elemente

Attribute

attribute	BESCHREIBUNG	Datentyp	Erforderlich
Name	Der Name der Dateitypzuordnung. Mit diesem Namen kannst du Dateitypen organisieren und gruppieren. Der Name darf nur Kleinbuchstaben und keine Leerzeichen umfassen.	Eine Zeichenfolge mit einem Wert zwischen 1 und 100 Zeichen.	Yes
DesiredView	Der gewünschte Bildschirmraum, der beim Starten der App verwendet werden soll. Diese Einstellung für den Ansichtsmodus ist nur ein angeforderter Wert. Die von Ihnen angegebene bevorzugte Größe wird von Windows nicht berücksichtigt. Daher sollten Sie keinen Code schreiben, der darauf angewiesen ist, niemals eine Größe zu erhalten, die kleiner als die bevorzugte Mindestgröße oder größer als die bevorzugte maximale Größe ist.	Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: default, useLess, useHalf, useMore oder useMinimum.	No
desktop2:UseUrl	Gibt bei Festlegung auf true an, dass die Anwendung eine URL anstelle eines Dateinamens in der Befehlszeile akzeptieren kann. Anwendungen, die Dokumente direkt aus dem Internet öffnen können, z. B. Webbrowser und Media Player, sollten diesen Wert verwenden. Wenn `ShellExecuteEx` eine Anwendung gestartet wird und dieser Wert auf false festgelegt ist, lädt das Standardverhalten `ShellExecuteEx` das Dokument in eine lokale Datei herunter und ruft den Handler für die lokale Kopie auf.	Ein optionaler boolescher Wert.	No
desktop2:AllowSilentDefaultTakeOver	Wenn true festgelegt ist, wird die App in der Liste "Öffnen mit" angezeigt, aber sie ist nicht die Standard-App für den Dateityp.	Ein optionaler boolescher Wert.	No
desktop5:ThumbnailTypeOverlay	Eine Bildressource für eine Miniaturansichtsüberlagerung.	Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die mit , oder endet und die folgende Zeichen nicht enthalten kann: `<`, `>`, `:`, `"`, `\|?`, oder `*`.`.jpeg.png.jpg` In dieser Zeichenfolge dürfen die `/` Zeichen und `\` nicht das erste oder letzte Zeichen sein. Außerdem kann die Zeichenfolge oder `\` enthalten`/`, aber nicht beides.	No

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
uap:DisplayName	Ein Anzeigename, der Benutzern angezeigt werden kann.
uap:EditFlags	Gibt den Typ der Informationen an, die dem Benutzer beim Öffnen einer Datei angezeigt werden, die dem Erweiterbarkeitspunkt zugeordnet ist.
uap:InfoTip	Definiert eine Zeichenfolge, die dem Benutzer zusätzliche Informationen zum Dateityp bereitstellt.
uap:Logo	Ein Pfad zu einer Datei, die ein Bild enthält.
uap:SupportedFileTypes (Typ: CT_FTASupportedFileTypes)	Definiert die dateitypen, die der App zugeordnet sind. Sie sind pro Paket eindeutig und beachten die Groß-/Kleinschreibung.
uap2:SupportedVerbs	Enthält Verben für ein Dateikontextmenü.
uap4:KindMap	Gibt an, was Kind ist und wie es verwendet wird.
rescap3:MigrationProgIds	Enthält ProgID-Werte (Programmatic Identifier ), die die Anwendung, Komponente und Version jeder Desktopanwendung beschreiben, von der Sie Dateizuordnungen erben möchten.
desktop2:ThumbnailHandler	Aktiviert einen ThumbnailProvider für eine Dateitypzuordnung.
desktop2:OleClass	Ermöglicht OLE das Abrufen der OLE-Klasse, die für eine bestimmte Dateierweiterung registriert ist.
desktop2:DesktopPreviewHandler	Aktiviert die Deklaration eines Vorschauhandlers für eine Dateitypzuordnung.
desktop2:DesktopPropertyHandler	Aktiviert die Deklaration eines Eigenschaftenhandlers für eine Dateitypzuordnung.
desktop3:PropertyLists	Enthält eine Liste der Eigenschaften, die auf der Registerkarte Eigenschaften einer Datei angezeigt werden sollen.
desktop7:Logo	Ein Pfad zu einer Datei, die ein Bild enthält. Fügt Unterstützung für ICO-Dateierweiterungen hinzu.
desktop7:ProgId	Ein programmgesteuerter Bezeichner (ProgID), der einer CLSID zugeordnet werden kann.
desktop10:IconHandler	Aktiviert einen IconHandler für eine Dateitypzuordnung.

Übergeordnete Elemente

Übergeordnetes Element	Beschreibung
uap:Extension	Deklariert einen Erweiterbarkeitspunkt für die App.

Anforderungen

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