CoreFrameworkInputView 클래스

정의

네임스페이스:

Windows.UI.ViewManagement.Core

해당 CoreInputViewPrimaryViewAnimationStarting 및 OcclusionsChanged 이벤트 이후에 PrimaryViewAnimationStarting 및 OcclusionsChanged 이벤트를 처리하는 기능을 UI 프레임워크에 제공합니다.

이렇게 하면 프레임워크가 도킹, 도킹 해제, 이동 가능 또는 일시적인 입력 창(및 연결된 UI)의 표시를 제어하고, 창을 이동, 표시 또는 숨길 때 알림을 수신하고, 앱 창의 어느 부분이 창으로 가려지는지 확인할 수 있습니다.

참고

HoloLens에서는 지원되지 않습니다.

public ref class CoreFrameworkInputView 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 CoreFrameworkInputView 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 CoreFrameworkInputView

Public NotInheritable Class CoreFrameworkInputView

상속

Object Platform::Object IInspectable CoreFrameworkInputView

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 11 (10.0.22000.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v14.0에서 도입되었습니다.)

설명

프레임워크(예: XAML) 또는 사용자 지정 텍스트 컨트롤에서만 사용됩니다.

프레임워크는 이 개체에 의해 노출된 정보를 사용하여 폐색을 고려하여 UI를 조정하고 재배치할 수 있습니다.

CoreFrameworkInputView API는 다음과 같은 유형의 입력 창을 지원합니다.

• 터치 키보드 및 필기 패널과 같은 도킹된 SIP(소프트 입력 패널)는 일반적으로 앱 UI가 재배치됩니다.
• 부동 도구 모음 또는 SIP – 일반적으로 앱 UI는 재배치되지 않습니다.
• 인라인 잉크 또는 IME 후보 창과 같은 오버레이 패널 – 일반적으로 앱 UI는 편집 컨트롤에 대해 재배치되지 않지만 텍스트/검색 제안에 대해 재배치됩니다.

입력 창은 사용자가 텍스트 필드 입력과 같은 정보를 제공해야 하는 작업을 수행할 때 나타납니다.

기본적으로 Windows는 사용자가 포커스가 있는 컨트롤을 볼 수 있도록 입력 창 이벤트를 처리하고 콘텐츠 위치를 변경합니다.

CoreFrameworkInputView.GetForCurrentView를 호출하여 CoreFrameworkInputView 개체를 가져옵니다.

입력 창 알림을 수신하도록 등록한 후 CoreFrameworkInputView.GetForCurrentView 메서드를 호출할 때 포그라운드 창에 대해 창이 표시되거나 숨겨질 때마다 시스템에서 이벤트 대리자를 호출합니다.

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)을 참조하세요.

메서드

GetForCurrentView()	현재 창과 연결된 CoreFrameworkInputView 개체를 검색합니다.
GetForUIContext(UIContext)	지정된 컨텍스트 식별자가 있는 뷰와 연결된 CoreFrameworkInputView 개체를 가져옵니다.

이벤트

OcclusionsChanged	CoreFrameworkInputView와 연결된 입력 창의 위치 변경에 대한 응답으로 하나 이상의 CoreInputViewOcclusion 개체가 위치 또는 폐색 영역을 변경할 때 발생합니다.
PrimaryViewAnimationStarting	CoreFrameworkInputView와 연결된 입력 창의 표시 또는 숨기기에 대한 응답으로 발생하는 애플리케이션의 애니메이션입니다.

추가 정보

• CoreInputView