DataRequestedEventArgs class

Applies to Windows and Windows Phone

Contains information about the DataRequested event. The system fires this event when the user invokes the Share UI.

Syntax


/* For information about creating or accessing this object, see Remarks. */

Attributes

[MarshalingBehavior(Agile)]
[Version(0x06020000)]

Members

The DataRequestedEventArgs class has these types of members:

Properties

The DataRequestedEventArgs class has these properties.

PropertyAccess typeDescription

Request

Read-onlyEnables you to get the DataRequest object and either give it data or a failure message.

 

Remarks

To share content from one app to another, a user invokes the Share UI. The most common way to do this is through the charms, although you can use the DataTransferManager class to launch the UI programmatically. When the Share UI launches, the system fires a datarequested event. The object included with this event is an instance of the DataRequestedEventArgs class.

This event has one property, request. This property contains an instance of the DataRequest class, which your app uses to supply the content the user wants to share with the target app.

Examples


function registerForShare() {
    var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", shareTextHandler);
}

function shareTextHandler(e) {
    var request = e.request;
    request.data.properties.title = "Share Text Example";
    request.data.properties.description = "A demonstration that shows how to share.";
    request.data.setText("Hello World!");
}


Requirements

Minimum supported client

Windows 8 [Windows Store apps only]

Minimum supported server

Windows Server 2012 [Windows Store apps only]

Minimum supported phone

Windows Phone 8

Namespace

Windows.ApplicationModel.DataTransfer
Windows::ApplicationModel::DataTransfer [C++]

Metadata

Windows.winmd

 

 

Show:
© 2014 Microsoft