ShareOperation クラス

リファレンス

定義

名前空間:: Windows.ApplicationModel.DataTransfer.ShareTarget

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

共有操作中の作業の大部分を処理します。これには、ユーザーが共有するデータ、QuickLinks の設定または削除、操作の状態に関するシステムへの通知が含まれます。

public ref class ShareOperation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class ShareOperation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class ShareOperation

Public NotInheritable Class ShareOperation

継承: Object Platform::Object IInspectable ShareOperation

属性: ContractVersionAttribute MarshalingBehaviorAttribute

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 で導入)

例

次の例は、ShareOperation オブジェクトを操作する方法を示しています。

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);
        }
    });
}

注釈

ユーザーが共有アクションのターゲットとしてアプリを選択すると、アクティブ化されたイベントが発生します。このイベントがアプリに送信するオブジェクトには、 ShareOperation クラスのインスタンスが含まれています。

現在 Share ターゲットとして開いているアプリは、追加の ShareOperation を開始したり、 FileOpenPicker または FileSavePicker を起動したりすることはできません。

すべての ShareOperation API は、Share ターゲットの CoreWindow がアクティブ化された後にのみ呼び出す必要があります。共有プラットフォームは、ウィンドウがアクティブ化された後にのみ、共有操作のエントリを作成します。

注意

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

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1709	16299	連絡先

プロパティ

Contacts	共有操作の連絡先を取得します。
Data	ユーザーが共有するデータを含む DataPackage オブジェクトが含まれます。
QuickLinkId	QuickLink の ID を含む文字列。

メソッド

DismissUI()	共有ウィンドウを閉じます。
RemoveThisQuickLink()	ユーザーが使用できる QuickLink の一覧から QuickLink を削除します。
ReportCompleted()	共有操作が完了したことを指定します。
ReportCompleted(QuickLink)	共有操作が完了したことを指定します。システムが将来の共有操作のショートカットとして保存できる QuickLink が含まれています。
ReportDataRetrieved()	ユーザーが共有するコンテンツをアプリが取得したことを指定します。
ReportError(String)	共有操作中にエラーが発生したことを指定します。
ReportStarted()	ユーザーが共有するコンテンツの取得をアプリが開始したことを指定します。
ReportSubmittedBackgroundTask()	共有操作をバックグラウンドタスクとして実行することをシステムが許可するようにアプリが要求したことを指定します。

適用対象