DataTransferManager.DataRequested 事件

定义

命名空间:

Windows.ApplicationModel.DataTransfer

在共享操作启动时发生。

// Register
event_token DataRequested(TypedEventHandler<DataTransferManager, DataRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void DataRequested(event_token const* cookie) const;

// Revoke with event_revoker
DataTransferManager::DataRequested_revoker DataRequested(auto_revoke_t, TypedEventHandler<DataTransferManager, DataRequestedEventArgs const&> const& handler) const;

public event TypedEventHandler<DataTransferManager,DataRequestedEventArgs> DataRequested;

function onDataRequested(eventArgs) { /* Your code */ }
dataTransferManager.addEventListener("datarequested", onDataRequested);
dataTransferManager.removeEventListener("datarequested", onDataRequested);
- or -
dataTransferManager.ondatarequested = onDataRequested;

Public Custom Event DataRequested As TypedEventHandler(Of DataTransferManager, DataRequestedEventArgs) 

事件类型

TypedEventHandler<DataTransferManager,DataRequestedEventArgs>

示例

此示例使用内联函数来处理 数据请求 事件。

//To see this code in action, add a call to ShareSourceLoad to your constructor or other
//initializing function.
private void ShareSourceLoad()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
}

private void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Text Example";
    request.Data.Properties.Description = "An example of how to share text.";
    request.Data.SetText("Hello World!");
}

注解

当应用以编程方式启动共享操作时，将触发此事件。 若要处理此事件，需要向活动窗口的 DataTransferManager 对象添加事件侦听器。 可以通过 GetForCurrentView 方法获取此对象。

处理 datarequested 事件时，需要注意的最重要属性是其 请求 属性。 此属性包含 DataRequest 对象。 你的应用使用此对象来提供用户希望与所选目标应用共享的数据。