DataTransferManager クラス

  • リファレンス

定義

名前空間:
Windows.ApplicationModel.DataTransfer
編集

プログラムによって、他のアプリとのコンテンツの交換を開始します。

public ref class DataTransferManager sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class DataTransferManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataTransferManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class DataTransferManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataTransferManager
Public NotInheritable Class DataTransferManager
継承
Object Platform::Object IInspectable DataTransferManager
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

この例では、 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!");
    });
}

注釈

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

DataTransferManager クラスには ShowShareUI メソッドが含まれており、これを使用してプログラムで共有操作を開始できます。

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

注意

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

Windows Phone 8

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

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1607 14393 Issupported
1703 15063 ShareProvidersRequested
1709 16299 ShowShareUI(ShareUIOptions)

メソッド

GetForCurrentView()

現在のウィンドウに関連付けられている DataTransferManager オブジェクトを返します。
IsSupported()

デバイスが共有をサポートしている場合は true、それ以外の場合は false を返します。
ShowShareUI()

プログラムによって、コンテンツを別のアプリと共有するためのユーザー インターフェイスを開始します。

この API は、ユニバーサル Windows プラットフォーム (UWP) アプリ用です。 デスクトップ アプリに使用する代替 API については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。
ShowShareUI(ShareUIOptions)

プログラムによって、コンテンツを別のアプリと共有するためのユーザー インターフェイスを開始します。

この API は、ユニバーサル Windows プラットフォーム (UWP) アプリ用です。 デスクトップ アプリに使用する代替 API については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。

イベント

DataRequested

共有操作の開始時に発生します。
ShareProvidersRequested

共有プロバイダーが要求されたときにトリガーされるイベント。 これはコールバックとして使用され、プロバイダーは、このイベントをサブスクライブし、イベント ハンドラーで ShareProvidersRequestedEventArgs.Providers.Add() を呼び出すことによって追加されます。
TargetApplicationChosen

ユーザーが共有 UI でターゲット アプリを選択したときに発生します。

適用対象

こちらもご覧ください