CoreInputView 클래스

정의

네임스페이스:

Windows.UI.ViewManagement.Core

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

참고

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

public ref class CoreInputView sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CoreInputView final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreInputView

Public NotInheritable Class CoreInputView

상속

Object Platform::Object IInspectable CoreInputView

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 Fall Creators Update (10.0.16299.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v5.0에서 도입되었습니다.)

설명

기본 보기는 CoreInputViewKind.Keyboard 또는 CoreInputViewKind.Handwriting 뷰 중 하나를 참조하는 반면 CoreInputView는 CoreInputViewKind.Handwriting의 값 중 하나일 수 있습니다.

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

앱은 이 개체에 의해 노출된 정보를 사용하여 모든 폐색을 고려하여 UI를 조정하고 재배치할 수 있습니다.

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

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

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

기본적으로 Windows는 입력 창 이벤트를 처리하고 사용자가 포커스를 사용하여 컨트롤을 볼 수 있도록 콘텐츠를 위치 변경합니다. 앱에서 CoreTextEditContext.InputPaneDisplayPolicy 를 수동 으로 설정한 경우 TryShowPrimaryView 및 TryHidePrimaryView를 사용하여 입력 창을 표시하고 숨겨야 합니다. 이 클래스를 사용하여 기본 동작을 재정의하고 입력 창을 사용자 지정합니다.

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

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

참고

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

버전 기록

Windows 버전	SDK 버전	추가된 값
1803	17134	TryTransferXYFocusToPrimaryView
1803	17134	XYFocusTransferredToPrimaryView
1803	17134	XYFocusTransferringFromPrimaryView
1809	17763	TryHide
1809	17763	TryShow
1809	17763	TryShow(CoreInputViewKind)
1903	18362	GetForUIContext
2004	19041	PrimaryViewHiding
2004	19041	PrimaryViewShowing

메서드

GetCoreInputViewOcclusions()	현재 앱을 차단하고 있는 각 입력 창에 대한 참조를 검색합니다.
GetForCurrentView()	현재 창과 연결된 CoreInputView 개체를 검색합니다.
GetForUIContext(UIContext)	지정된 컨텍스트 식별자가 있는 뷰와 연결된 CoreInputView 개체를 가져옵니다.
IsKindSupported(CoreInputViewKind)	지정된 CoreInputView 형식이 지원되는지 여부를 가져옵니다.
TryHide()	CoreInputView 창과 연결된 입력 창을 숨기려고 시도합니다(표시되는 경우).
TryHidePrimaryView()	CoreInputView와 연결된 입력 창을 숨기려고 시도합니다(표시되는 경우).
TryShow()	CoreInputView와 연결된 입력 창을 표시하려고 시도합니다(숨겨진 경우).
TryShow(CoreInputViewKind)	CoreInputView와 연결된 지정된 형식의 입력 창을 표시하려고 시도합니다(숨겨진 경우).
TryShowPrimaryView()	CoreInputView 창을 표시하려고 시도합니다(숨겨진 경우). 이 방법은 "최선의 노력"이며 사용자가 포커스가 있는 컨트롤과 상호 작용할 수 있는 방법만 보장합니다. 터치 키보드 및 필기 패널과 같은 도킹된 SIP(소프트 입력 패널)의 경우 하드웨어 키보드를 사용할 수 없는 경우에만 창이 표시됩니다.
TryTransferXYFocusToPrimaryView(Rect, CoreInputViewXYFocusTransferDirection)	애플리케이션 UI에서 입력 창으로 포커스를 이동하려고 시도합니다.

이벤트

OcclusionsChanged	CoreInputView와 연결된 입력 창의 위치 변경에 대한 응답으로 하나 이상의 CoreInputViewOcclusion 개체가 위치 또는 폐색 영역을 변경할 때 발생합니다.
PrimaryViewAnimationStarting	CoreInputView 기본 보기의 표시 또는 숨기기에 대한 응답으로 발생하는 애플리케이션의 애니메이션입니다.
PrimaryViewHiding	CoreInputView와 연결된 입력 창이 숨겨지기 전에 발생합니다(표시되는 경우).
PrimaryViewShowing	CoreInputView와 연결된 입력 창이 표시되기 전에 발생합니다(숨겨진 경우).
SupportedKindsChanged	CoreInputView에 대해 지원되는 CoreInputViewKind 뷰의 컬렉션이 변경되면 발생합니다.
XYFocusTransferredToPrimaryView	포커스가 애플리케이션 UI에서 입력 창으로 이동할 때 발생합니다.
XYFocusTransferringFromPrimaryView	입력 창이 포커스를 잃기 전과 UI 요소가 포커스를 가져오기 전에 발생합니다.

추가 정보

• CoreFrameworkInputView