StandardDataFormats class

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.

Syntax

var standardDataFormats = Windows.ApplicationModel.DataTransfer.StandardDataFormats;

Attributes

DualApiPartitionAttribute()

MarshalingBehaviorAttribute(Agile)

StaticAttribute(Windows.ApplicationModel.DataTransfer.IStandardDataFormatsStatics, NTDDI_WIN8)

VersionAttribute(NTDDI_WIN8)

Members

The StandardDataFormats class has these types of members:

• Methods
• Properties

Methods

The StandardDataFormats class inherits methods from the Object class (C#/VB/C++).

Properties

The StandardDataFormats class has these properties.

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 Windows Store apps 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.

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 Windows Store apps and desktop apps.

Examples

This example shows how to retrieve shared text.

var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
    shareOperation.data.getTextAsync().done(function (text) {
            // To output the text using this example, 
            // you need a div tag with an id of "output" in your HTML file.
            document.getElementById("output").innerText = text;
        }, function (e) {
            displayError("Error retrieving Text format: " + e);
        }
    });
}

Requirements

Build date: 2/25/2013