ShareOperation 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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
- 继承
- 属性
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 类的实例。
当前作为共享目标打开的应用无法启动其他 ShareOperation,也无法启动 FileOpenPicker 或 FileSavePicker。
只有在 激活 Share 目标的 CoreWindow 之后,才应调用所有 ShareOperation API。 仅在激活窗口后,Share 平台才会为共享操作创建一个条目。
注意
此类不敏捷,这意味着需要考虑其线程模型和封送处理行为。 有关详细信息,请参阅线程和封送处理 (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() |
指定应用已请求系统允许共享操作作为后台任务运行。 |