uap:ShareTarget (Windows 10)

Article
10/30/2023

Declares an app extension point of type windows.shareTarget. The app can share the specified types of files.

Element hierarchy

<uap:Extension>

<uap:ShareTarget>

Syntax

<uap:ShareTarget
  Description = 'An optional string with a value between 1 and 256 characters in length.' >

  <!-- Child elements -->
  uap:SupportedFileTypes?
  uap:DataFormat{0,10000}

</uap:ShareTarget>

Key

? optional (zero or one) {} specific range of occurrences

Attributes and elements

Attributes

Attribute	Description	Data type	Required	Default value
Description	The description of the share target.	An optional string with a value between 1 and 256 characters in length.	No

Child elements

Child element	Description
uap:DataFormat	Specifies a data package format such as text or HTML format that the app can share. It is unique per application in the package and is case sensitive.
uap:SupportedFileTypes (type: CT_CharmsSupportedFileTypes)	Defines the file types that the app can share.

Parent elements

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

Remarks

The Share feature provides access to a list of target apps that can receive data that the user wants to share. This extensibility point enables your app to be included in the list of share targets.

ShareTarget must specify either SupportedFileTypes element, or at least one DataFormat element. It cannot omit both. The schema allows omitting both, but semantic validation will fail.

Examples

<uap:Extension
  Category="windows.shareTarget">
  <uap:ShareTarget>
    <uap:SupportedFileTypes>
      <uap:SupportsAnyFileType />
    </uap:SupportedFileTypes>
    <uap:DataFormat>Text</uap:DataFormat>
    <uap:DataFormat>Uri</uap:DataFormat>
    <uap:DataFormat>Bitmap</uap:DataFormat>
    <uap:DataFormat>Html</uap:DataFormat>
    <uap:DataFormat>http://schema.org/Book</DataFormat>
  </uap:ShareTarget>
</uap:Extension>

Requirements

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

Share via