CoreTextEditContext 클래스

정의

네임스페이스:

Windows.UI.Text.Core

텍스트 입력 컨트롤에서 텍스트 입력 서버와 통신하는 데 사용되는 기본 개체입니다.

public ref class CoreTextEditContext sealed

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

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

Public NotInheritable Class CoreTextEditContext

상속

Object Platform::Object IInspectable CoreTextEditContext

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

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

설명

이 형식의 개체를 가져오려면 CoreTextServicesManager.CreateEditContext를 호출합니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1511	10586	NotifyFocusLeaveCompleted

속성

InputPaneDisplayPolicy	포커스가 텍스트 입력 컨트롤에 들어갈 때 입력 창을 자동으로 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. 기본값은 자동이며 입력 창이 자동으로 표시되도록 나타냅니다. 수동 값은 앱이 InputPane.TryShow 및 TryHide를 사용하여 입력 창을 표시하고 숨길 책임이 있음을 나타냅니다.
InputScope	텍스트 입력 컨트롤의 입력 scope 나타내는 값을 가져오거나 설정합니다.
IsReadOnly	편집 컨트롤을 편집할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
Name	텍스트 입력 컨트롤의 설명이 포함된 이름을 가져오거나 설정합니다. 애플리케이션 프레임워크는 일반적으로 "이름" 또는 "id"와 같은 속성을 사용하여 컨트롤을 식별하므로 입력 프로세서가 입력 컨텍스트를 더 잘 보존하고 더 나은 제안을 제공할 수 있도록 텍스트 입력 서버에서 이 속성을 적절하게 설정하는 것이 좋습니다.

메서드

NotifyFocusEnter()	포커스가 텍스트 입력 컨트롤에 입력되었음을 텍스트 입력 서버에 알립니다.
NotifyFocusLeave()	포커스가 텍스트 입력 컨트롤을 떠났다는 것을 텍스트 입력 서버에 알립니다.
NotifyLayoutChanged()	텍스트 입력 컨트롤 내의 텍스트 레이아웃이 변경되었음을 텍스트 입력 서버에 알립니다.
NotifySelectionChanged(CoreTextRange)	텍스트 입력 컨트롤이 선택 범위에 적용해야 하는 변경 내용에 대해 텍스트 입력 서버에 알립니다. 이는 컨트롤의 내부 상태와 서버의 내부 상태를 동기화된 상태로 유지하기 위해 중요합니다.
NotifyTextChanged(CoreTextRange, Int32, CoreTextRange)	텍스트 입력 컨트롤이 텍스트에 대해 수행해야 하는 변경 내용에 대해 텍스트 입력 서버에 알립니다. 이는 컨트롤의 내부 상태와 서버의 내부 상태를 동기화된 상태로 유지하기 위해 중요합니다. 텍스트 변경 내용도 선택 범위에 영향을 줄 수 있으므로 메서드는 선택 범위를 매개 변수로 사용합니다.

이벤트

CompositionCompleted	컴퍼지션이 완료되면 발생합니다.
CompositionStarted	컴퍼지션이 시작될 때 발생합니다.
FocusRemoved	텍스트 입력 컨트롤에서 포커스가 강제로 제거되었을 때 발생합니다. 애플리케이션에 따라 텍스트 입력 컨트롤에 대 한 포커스를 제거 하려면이 이벤트를 처리 해야 합니다.
FormatUpdating	텍스트 입력 서버가 특정 텍스트 범위에 다른 형식을 적용해야 할 때 발생합니다. 이는 일반적으로 컴퍼지션 중에 발생합니다.
LayoutRequested	텍스트 입력 서버가 텍스트 범위와 텍스트 입력 컨트롤 자체의 경계 상자를 가져와야 할 때 발생합니다. 애플리케이션은 이 이벤트를 처리하고 요청된 기하 도형 정보를 반환해야 합니다.
NotifyFocusLeaveCompleted	포커스가 텍스트 입력 컨트롤을 떠난 후에 발생합니다.
SelectionRequested	텍스트 입력 서버가 텍스트 입력 컨트롤에서 현재 선택된 텍스트를 나타내는 텍스트 범위를 가져와야 할 때 발생합니다. 애플리케이션이 이 이벤트를 처리하고 요청된 범위를 반환해야 합니다.
SelectionUpdating	텍스트 입력 서버가 텍스트 입력 컨트롤에서 현재 선택된 텍스트 범위를 수정해야 할 때 발생합니다. 이 이벤트는 일부 텍스트를 선택하거나 캐리트를 이동해야 하는 입력 프로세서의 결과일 수 있습니다. 텍스트 입력 컨트롤은 그에 따라 선택 범위를 설정해야 합니다.
TextRequested	텍스트 입력 서버가 텍스트 입력 컨트롤에서 텍스트 범위를 가져와야 할 때 발생합니다. 애플리케이션이 이 이벤트를 처리하고 요청된 범위를 반환해야 합니다.
TextUpdating	텍스트 입력 서버가 텍스트 입력 컨트롤 내에서 텍스트를 수정해야 할 때 발생합니다. 이 이벤트는 단일 문자 삽입과 같은 키 이벤트의 결과이거나 자동 수정 및 예측과 같은 입력 프로세서에서 수행된 처리 결과일 수 있습니다. 이벤트를 처리할 때 텍스트 입력 컨트롤은 범위를 서버에서 제공하는 새 텍스트로 바꾸고 새 텍스트의 끝으로도 이동해야 합니다.

추가 정보

• 사용자 지정 편집 컨트롤 샘플