エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

DataTransferManager Class

他のアプリケーションとのコンテンツ交換をプログラムで開始します。

構文


var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();

属性

[MarshalingBehavior(Standard)]
[Muse()]
[Version(0x06020000)]

メンバー

DataTransferManagerクラス には次の種類のメンバーがあります。

イベント

DataTransferManagerクラス にはこれらのイベントがあります。

イベント説明
DataRequested Occurs when a share operation starts.
TargetApplicationChosen Occurs when the user chooses a target app in the Share charm.

 

メソッド

The DataTransferManager クラス には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
GetForCurrentView Returns the DataTransferManager object associated with the current window.
ShowShareUI Programmatically initiates the user interface for sharing content with another app.

 

解説

DataTransferManager クラスは、共有操作を開始するために使用する静的クラスです。クラスを使用するには、最初に GetForCurrentView メソッドを呼び出します。このメソッドは、アクティブ ウィンドウに固有の DataTransferManager オブジェクトを返します。次に、datarequested イベントに対するイベント リスナーをこのオブジェクトに追加する必要があります。このイベントは、共有操作を開始すると発生します — 通常は、ユーザーが共有チャームをタップすることで開始されますが、プログラムで共有操作が開始された場合にも発生します。

DataTransferManager クラスには、共有操作をプログラム的に開始するために使用できる ShowShareUI メソッドが含まれます。一般に、このメソッドの使用をお勧めしません。操作をプログラムで起動して、矛盾したユーザー エクスペリエンスを作成する場合、ユーザーは共有チャーム—を使用して、共有操作を開始する必要があります。ユーザーが共有する機会を認識しない可能性があるシナリオがいくつか存在するため、メソッドが含まれています。その良い例が、ユーザーがゲームで高得点を獲得するときです。

DataTransferManager クラスには、TargetApplicationChosen イベントもあります。このイベントは、アプリケーションからのコンテンツを共有するときにユーザーが選択するアプリケーションをキャプチャする場合に使用します。

メモ  : このクラスはアジャイルではないため、そのスレッド モデルとマーシャリングの動作を考慮する必要があります。詳細については、「スレッド処理とマーシャリング (C++/CX)」および「Using Windows Runtime objects in a multithreaded environment (.NET) (マルチスレッド環境での Windows ランタイム オブジェクトの使用 (.NET))」を参照してください。

Windows Phone 8

この API は、ネイティブ アプリでのみサポートされます。

この例では、DataTransferManager オブジェクトを使用する一般的な方法を示します。


    function setupShare() {
        var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
        dataTransferManager.addEventListener("datarequested", function (e) {
            var request = e.request;
            request.data.properties.title = "Share Demonstration";
            request.data.setText("Hello World!");
        });
    }


要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

最小限サポートされる携帯電話

Windows Phone 8

名前空間

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

メタデータ

Windows.winmd

 

 

表示:
© 2014 Microsoft