ShareWindowCommandSource 클래스

  • 참조

정의

네임스페이스:
Windows.UI.Shell
편집

통신 앱이 창 공유를 시작하고 중지하기 위한 UI를 표시하기 위해 Window Shell과의 통신을 설정하는 데 사용할 수 있는 개체를 나타냅니다.

ShareWindowCommandSource의 instance 가져오고 등록하여 instance ShareWindowCommandSource.CommandRequested 및 ShareWindowCommandSource.CommandInvoked 이벤트를 처리합니다. 이러한 이벤트는 Windows 셸에서 발생합니다.

중요

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 셸은 이를 사용하여 다음을 수행합니다.

  • 공유 명령과 함께 표시될 아이콘 및 이름과 같은 애플리케이션 ID 정보를 가져옵니다.
  • 여러 공유 명령 원본 중에서 선택합니다. 가장 최근에 사용한 공유 앱이 선택됩니다.

이벤트는 명령을 요청하고 호출하는 데 사용되며, 여기에는 공유할 창의 WindowId 가 포함됩니다.

IShareWindowCommandSourceInterop 은 ShareWindowCommandSource 개체를 가져오는 데 사용할 수 있는 네이티브 상호 운용 인터페이스입니다.

메서드

GetForCurrentView()

ShareWindowCommandSource의 instance 가져오는 데 사용할 수 있는 정적 메서드입니다.

중요

ShareWindowCommandSource.GetForCurrentView API는 제한된 액세스 기능의 일부입니다(LimitedAccessFeatures 클래스 참조). 자세한 내용을 확인하거나 잠금 해제 토큰을 요청하려면 Microsoft 지원 문의하세요.
ReportCommandChanged()

통신 앱의 공유 상태가 변경되었음을 Windows Shell에 나타냅니다.

통신 앱의 공유 상태가 변경 될 때마다이 메서드를 호출 합니다. 통화 또는 모임에서 새 창을 성공적으로 공유하거나 이미 공유된 창(사용자 고유의 UI를 통해 또는 Windows 작업 표시줄 작업에 의해 트리거됨)을 제거한 경우 ReportCommandChanged를 호출하여 ShareWindowCommandSource instance 해당 변경 내용을 알려야 합니다.

그런 다음 셸은 ShareWindowCommandSource.CommandRequested 이벤트의 일부로 받은 모든 정보를 플러시하고 표시되는 공유 명령을 앱의 현재 상태와 일치하도록 업데이트합니다.
Start()

호출 앱이 현재 창 공유 명령의 원본임을 나타냅니다. 통화 또는 모임 중에 이 메서드를 호출하여 통신 앱을 창 공유 명령의 원본으로 사용하도록 설정합니다.
Stop()

호출 앱이 창 공유 명령의 원본이 아님을 나타냅니다. 통화 또는 모임이 종료되면 이 메서드를 호출하여 통신 앱을 창 공유 명령의 원본으로 사용하지 않도록 설정합니다.

이벤트

CommandInvoked

통신 앱이 실제로 특정 창 공유를 시작하거나 중지할 수 있는 기회를 제공하기 위해 Windows Shell에서 발생하는 이벤트입니다.
CommandRequested

통신 앱에 특정 창 공유 시작 또는 중지를 지원할 수 있는 기회를 제공하기 위해 Windows Shell에서 발생하는 이벤트입니다.

적용 대상

추가 정보