次の方法で共有

ShareOperation クラス

  • リファレンス

定義

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

共有操作中の作業の大部分を処理します。 これには、ユーザーが共有するデータ、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()

共有操作をバックグラウンド タスクとして実行することをシステムが許可するようにアプリが要求したことを指定します。

適用対象

こちらもご覧ください