InputPane 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
도킹된 터치 키보드 또는 SIP(소프트 입력 패널)가 표시되거나 숨겨질 때 앱이 알림을 수신하고 입력 창으로 인해 응용 프로그램 창의 어느 부분이 가려지는지 확인할 수 있습니다.
참고
InputPane API는 도킹된 패널에 대해서만 정확한 폐색 정보를 제공합니다. Windows 10 크리에이터 가을 업데이트 이상에서는 다음 API를 사용하여 SIP(소프트 입력 패널), IME(입력 방법 편집기) 후보 창, 부동 도구 모음 등과 같은 도킹, 도킹 해제, 이동 가능 및 일시적인 입력 창으로 폐색을 처리하는 것이 좋습니다.
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 InputPanePublic NotInheritable Class InputPane- 상속
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
설명
입력 창은 사용자가 텍스트 입력 필드 선택과 같은 정보를 입력해야 하는 작업을 수행할 때 나타납니다. 기본적으로 Windows는 입력 창 이벤트를 처리하고 사용자가 입력하는 위치를 볼 수 있도록 콘텐츠의 위치를 변경합니다. 앱에서 CoreTextEditContext.InputPaneDisplayPolicy 를 수동 으로 설정한 경우 TryShow 및 TryHide를 사용하여 입력 창을 표시하고 숨겨야 합니다. 이 클래스를 사용하여 기본 동작을 재정의하고 입력 창을 사용자 지정합니다.
경우에 따라 InputPane과 같은 오버레이 UI가 완전히 지원되지 않습니다. 다음 내용이 포함됩니다.
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 |
입력 창이 보기로 슬라이딩하기 시작할 때 발생합니다. |