Windows.ApplicationModel.DataTransfer.StandardDataFormats
March 27, 2021 ยท View on GitHub
-description
Contains static properties that return string values. Each string corresponds to a known format ID. Use this class to avoid errors in using string constants to specify data formats.
-remarks
The DataPackage class supports several format types. Whenever you need to specify a format, we recommend using the properties of the StandardDataFormats class, instead of string values. Doing so ensures consistency between source and target applications.
The DataPackage class supports a number of legacy formats for interoperability between UWP app and desktop apps. To retrieve these formats, you pass one of the following strings to the DataPackageView.GetDataAsync method instead of a value from the StandardDataFormats class.
| If format name is: | GetDataAsync() retrieves: |
|---|---|
| "AnsiText" | String for CF_TEXT. |
| "DeviceIndependentBitmap" | Stream for HGLOBAL corresponding to CF_DIB. |
| "DeviceIndependentBitmapV5" | Stream for HGLOBAL corresponding to CF_DIBV5. |
| "DataInterchangeFormat" | Stream for HGLOBAL corresponding to CF_DIF. |
| "EnhancedMetafile" | Stream for HENHMETAFILE corresponding to CF_ENHMETAFILE. |
| "Locale" | Stream for HGLOBAL corresponding to CF_LOCALE |
| "OEMText" | String for CF_OEMTEXT. |
| "PenData" | Stream for HGLOBAL corresponding to CF_PENDATA |
| "RiffAudio" | Stream for HGLOBAL corresponding to CF_RIFF. |
| "SymbolicLink" | Stream for HGLOBAL corresponding to CF_SYLK. |
| "TaggedImageFileFormat" | Stream for HGLOBAL corresponding to CF_TIFF. |
| "WaveAudio" | Stream for HGLOBAL corresponding to CF_WAVE. |
The Windows Runtime provides limited support for metafiles. Specifically, the Windows Runtime:
- Supports rendering metafiles, but not creating them.
- Supports the CF_ENHMETAFILE format ("EnhancedMetafile"), but not CF_METAFILEPICT.
- Supports requesting data in "EnhancedMetafile" format, but not providing it; that is, calling
SetData("EnhancedMetafile", <data>)won't work. - Provides limited support through the clipboard API for exchanging metafiles between UWP app and desktop apps.
Version history
| Windows version | SDK version | Value added |
|---|---|---|
| 1803 | 17134 | UserActivityJsonArray |
-examples
This example shows how to retrieve shared text (by using StandardDataFormats.Text) or a shared file or folder (by using StandardDataFormats.StorageItems). For more examples, see the Clipboard sample and the ShareTarget sample.
[!code-csHowToReceiveShare]