ShareWindowCommandSource 类

  • 参考

定义

命名空间:
Windows.UI.Shell
编辑

表示一个对象，通信应用可以使用该对象设置与 Window Shell 的通信，以显示用于启动和停止窗口共享的 UI。

获取 ShareWindowCommandSource 的实例，并注册以处理实例的 ShareWindowCommandSource.CommandRequested 和 ShareWindowCommandSource.CommandInvoked 事件。 这些事件由 Windows Shell 引发。

重要

Windows.UI.Shell.ShareWindowCommandSource API 是受限访问功能的一部分 (请参阅 LimitedAccessFeatures 类) 。 有关详细信息或请求解锁令牌，请联系 Microsoft 支持部门。

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

Windows 要求

设备系列
Windows 11 (在 10.0.22000.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v14.0 中引入)

注解

此功能增强了应用程序已实现的窗口共享功能，提供了用于选择窗口的替代方法。 该设计允许应用显示开始共享和停止共享命令;以与应用共享一个或多个窗口的能力相对应的方式实现这些窗口。

通信应用标识与共享窗口的功能相对应的窗口，即单个应用窗口，或承载通信会话 (呼叫) 的窗口。 Windows Shell 使用此函数来：

  • 获取应用程序标识信息，例如其图标和名称，这些信息将与共享命令一起显示。
  • 在多个共享命令源之间进行选择。 将选择最近使用的共享应用。

事件用于请求命令并调用它们，这包括要共享的窗口的 WindowId 。

IShareWindowCommandSourceInterop 是一个本机互操作接口，允许获取 ShareWindowCommandSource 对象。

方法

GetForCurrentView()

一种静态方法，可用于获取 ShareWindowCommandSource 的实例。

重要

ShareWindowCommandSource.GetForCurrentView API 是受限访问功能的一部分， (请参阅 LimitedAccessFeatures 类) 。 有关详细信息或请求解锁令牌，请联系 Microsoft 支持部门。
ReportCommandChanged()

向 Windows Shell 指示通信应用的共享状态已更改。

每当通信应用的共享状态发生更改时，调用此方法。 如果在通话或会议中成功共享新窗口，或者删除已共享窗口 (无论是通过自己的 UI，还是由 Windows 任务栏操作) 触发，则必须通过调用 ReportCommandChanged 来通知 ShareWindowCommandSource 实例该更改。

然后，Shell 将刷新作为任何 ShareWindowCommandSource.CommandRequested 事件的一部分收到的任何信息，并更新其可见的共享命令以匹配应用的当前状态。
Start()

指示调用应用当前是窗口共享命令的源。 在通话或会议期间调用此方法，以启用通信应用作为窗口共享命令的源。
Stop()

指示调用应用不是窗口共享命令的源。 在通话或会议结束时调用此方法，以禁用通信应用作为窗口共享命令的源。

事件

CommandInvoked

Windows Shell 引发的事件，使通信应用有机会实际启动或停止共享特定窗口。
CommandRequested

Windows Shell 引发的事件，使通信应用有机会支持启动或停止共享特定窗口。

适用于

另请参阅