InputPane 클래스

정의

네임스페이스:

Windows.UI.ViewManagement

도킹된 터치 키보드 또는 SIP(소프트 입력 패널)가 표시되거나 숨겨질 때 앱이 알림을 수신하고 입력 창으로 인해 응용 프로그램 창의 어느 부분이 가려지는지 확인할 수 있습니다.

참고

InputPane API는 도킹된 패널에 대해서만 정확한 폐색 정보를 제공합니다. Windows 10 크리에이터 가을 업데이트 이상에서는 다음 API를 사용하여 SIP(소프트 입력 패널), IME(입력 방법 편집기) 후보 창, 부동 도구 모음 등과 같은 도킹, 도킹 해제, 이동 가능 및 일시적인 입력 창으로 폐색을 처리하는 것이 좋습니다.

• CoreInputView
• CoreInputViewOcclusion
• CoreInputViewOcclusionKind

public ref class InputPane sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class InputPane final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class InputPane

Public NotInheritable Class InputPane

상속

Object Platform::Object IInspectable InputPane

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

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

설명

입력 창은 사용자가 텍스트 입력 필드 선택과 같은 정보를 입력해야 하는 작업을 수행할 때 나타납니다. 기본적으로 Windows는 입력 창 이벤트를 처리하고 사용자가 입력하는 위치를 볼 수 있도록 콘텐츠의 위치를 변경합니다. 앱에서 CoreTextEditContext.InputPaneDisplayPolicy 를 수동 으로 설정한 경우 TryShow 및 TryHide를 사용하여 입력 창을 표시하고 숨겨야 합니다. 이 클래스를 사용하여 기본 동작을 재정의하고 입력 창을 사용자 지정합니다.

경우에 따라 InputPane과 같은 오버레이 UI가 완전히 지원되지 않습니다. 다음 내용이 포함됩니다.

• 게임과 같은 전체 화면 모드의 앱
• 홀로그램 보기의 Windows 홀로그램 앱.

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

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

참고

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

버전 기록

Windows 버전	SDK 버전	추가된 값
1903	18362	GetForUIContext

속성

OccludedRect	입력 창으로 가려진 앱 창의 영역을 가져옵니다.
Visible	입력 창이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다. 중요 Xbox 장치 패밀리에만 유효합니다. 유니버설 앱의 경우 OccludedRect 속성은 입력 창에 의해 차단된 앱 창의 영역을 나타냅니다.

메서드

GetForCurrentView()	현재 표시되는 애플리케이션 창과 연결된 InputPane 개체를 가져옵니다.
GetForUIContext(UIContext)	지정된 컨텍스트 식별자를 사용하여 뷰와 연결된 InputPane 개체를 가져옵니다.
TryHide()	InputPane이 표시되는 경우 숨기려고 시도합니다.
TryShow()	숨겨진 경우 InputPane을 표시하려고 시도합니다. 이 방법은 "최선의 노력"이며 사용자가 포커스가 있는 컨트롤에 텍스트를 입력할 수 있는 방법만 보장합니다. 터치 키보드 또는 SIP(소프트 입력 패널)는 하드웨어 키보드를 사용할 수 없는 경우에만 표시됩니다.

이벤트

Hiding	입력 창이 보기 밖으로 슬라이딩하기 시작할 때 발생합니다.
Showing	입력 창이 보기로 슬라이딩하기 시작할 때 발생합니다.

추가 정보

• 터치 키보드의 현재 상태에 응답