ShareWindowCommandSource 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
통신 앱이 창 공유를 시작하고 중지하기 위한 UI를 표시하기 위해 Window Shell과의 통신을 설정하는 데 사용할 수 있는 개체를 나타냅니다.
ShareWindowCommandSource의 instance 가져오고 등록하여 instance ShareWindowCommandSource.CommandRequested 및 ShareWindowCommandSource.CommandInvoked 이벤트를 처리합니다. 이러한 이벤트는 Windows 셸에서 발생합니다.
중요
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 셸은 이를 사용하여 다음을 수행합니다.
- 공유 명령과 함께 표시될 아이콘 및 이름과 같은 애플리케이션 ID 정보를 가져옵니다.
- 여러 공유 명령 원본 중에서 선택합니다. 가장 최근에 사용한 공유 앱이 선택됩니다.
이벤트는 명령을 요청하고 호출하는 데 사용되며, 여기에는 공유할 창의 WindowId 가 포함됩니다.
IShareWindowCommandSourceInterop 은 ShareWindowCommandSource 개체를 가져오는 데 사용할 수 있는 네이티브 상호 운용 인터페이스입니다.
메서드
| GetForCurrentView() |
ShareWindowCommandSource의 instance 가져오는 데 사용할 수 있는 정적 메서드입니다. 중요 ShareWindowCommandSource.GetForCurrentView API는 제한된 액세스 기능의 일부입니다(LimitedAccessFeatures 클래스 참조). 자세한 내용을 확인하거나 잠금 해제 토큰을 요청하려면 LAF 액세스 토큰 요청 양식을 사용하세요. |
| ReportCommandChanged() |
통신 앱의 공유 상태가 변경되었음을 Windows Shell에 나타냅니다. 통신 앱의 공유 상태가 변경 될 때마다이 메서드를 호출 합니다. 통화 또는 모임에서 새 창을 성공적으로 공유하거나 이미 공유된 창(사용자 고유의 UI를 통해 또는 Windows 작업 표시줄 작업에 의해 트리거됨)을 제거한 경우 ReportCommandChanged를 호출하여 ShareWindowCommandSource instance 해당 변경 내용을 알려야 합니다. 그런 다음 셸은 ShareWindowCommandSource.CommandRequested 이벤트의 일부로 받은 모든 정보를 플러시하고 표시되는 공유 명령을 앱의 현재 상태와 일치하도록 업데이트합니다. |
| Start() |
호출 앱이 현재 창 공유 명령의 원본임을 나타냅니다. 통화 또는 모임 중에 이 메서드를 호출하여 통신 앱을 창 공유 명령의 원본으로 사용하도록 설정합니다. |
| Stop() |
호출 앱이 창 공유 명령의 원본이 아님을 나타냅니다. 통화 또는 모임이 종료되면 이 메서드를 호출하여 통신 앱을 창 공유 명령의 원본으로 사용하지 않도록 설정합니다. |
이벤트
| CommandInvoked |
통신 앱이 실제로 특정 창 공유를 시작하거나 중지할 수 있는 기회를 제공하기 위해 Windows Shell에서 발생하는 이벤트입니다. |
| CommandRequested |
통신 앱에 특정 창 공유 시작 또는 중지를 지원할 수 있는 기회를 제공하기 위해 Windows Shell에서 발생하는 이벤트입니다. |