共用方式為

ShareWindowCommandSource 類別

  • 參考

定義

命名空間:
Windows.UI.Shell
編輯

表示您的通訊應用程式可用來設定與 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 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 類別) 。 如需詳細資訊或要求解除鎖定令牌，請使用 LAF存取令牌要求表單。
ReportCommandChanged()

向 Windows Shell 指出通訊應用程式的共享狀態已變更。

每當通訊應用程式的共享狀態變更時，請呼叫此方法。 如果您成功在通話或會議中共用新的視窗，或移除已共用視窗 (無論是透過您自己的UI，還是由Windows任務欄動作觸發，) ，您必須呼叫 ReportCommandChanged 來通知 ShareWindowCommandSource 實例該變更。

Shell 接著會排清它作為任何 ShareWindowCommandSource.CommandRequested 事件的一部分收到的任何資訊，並更新其可見的共享命令，以符合您應用程式的目前狀態。
Start()

指出呼叫的應用程式目前是視窗共用命令的來源。 在通話或會議期間呼叫此方法，以讓您的通訊應用程式成為視窗共用命令的來源。
Stop()

表示呼叫的應用程式不是視窗共用命令的來源。 當通話或會議結束時呼叫此方法，以停用通訊應用程式作為視窗共用命令的來源。

事件

CommandInvoked

Windows Shell 引發的事件，可讓您的通訊應用程式實際啟動或停止共用特定視窗。
CommandRequested

Windows Shell 引發的事件，可讓您的通訊應用程式有機會開始或停止共用特定視窗。

適用於

另請參閱