ShareWindowCommandSource 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示一个 对象，通信应用可以使用该对象来设置与 Window Shell 的通信，以显示用于启动和停止窗口共享的 UI。
获取 ShareWindowCommandSource 的实例，并注册以处理该实例的 ShareWindowCommandSource.CommandRequested 和 ShareWindowCommandSource.CommandInvoked 事件。 这些事件由 Windows Shell 引发。
重要
Windows.UI.Shell.ShareWindowCommandSource API 是受限访问功能的一部分， (请参阅 LimitedAccessFeatures 类) 。 有关详细信息或请求解锁令牌，请使用 LAF 访问令牌请求表单。
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 ShareWindowCommandSourcePublic NotInheritable Class ShareWindowCommandSource- 继承
- 属性
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 类) 。 有关详细信息或请求解锁令牌，请使用 LAF 访问令牌请求表单。 |
| ReportCommandChanged() |
向 Windows Shell 指示通信应用的共享状态已更改。 每当通信应用的共享状态更改时，调用此方法。 如果在通话或会议中成功共享新窗口，或者删除了已共享窗口 (无论是通过自己的 UI 还是由 Windows 任务栏操作) 触发，则必须通过调用 ReportCommandChanged 来通知 ShareWindowCommandSource 实例该更改。 然后，Shell 将刷新作为任何 ShareWindowCommandSource.CommandRequested 事件的一部分收到的任何信息，并将更新其可见的共享命令以匹配应用的当前状态。 |
| Start() |
指示调用应用当前是窗口共享命令的源。 在通话或会议期间调用此方法，以启用通信应用作为窗口共享命令的源。 |
| Stop() |
指示调用应用不是窗口共享命令的源。 在通话或会议结束时调用此方法，以禁用通信应用作为窗口共享命令的源。 |
事件
| CommandInvoked |
由 Windows Shell 引发的事件，使通信应用有机会实际启动或停止共享特定窗口。 |
| CommandRequested |
由 Windows Shell 引发的事件，使通信应用有机会支持启动或停止共享特定窗口。 |