IInputConnection 인터페이스

정의

[Android.Runtime.Register("android/view/inputmethod/InputConnection", "", "Android.Views.InputMethods.IInputConnectionInvoker")]
public interface IInputConnection : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/view/inputmethod/InputConnection", "", "Android.Views.InputMethods.IInputConnectionInvoker")>]
type IInputConnection = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

파생

Android.Views.InputMethods.BaseInputConnection

Android.Views.InputMethods.InputConnectionWrapper

특성

RegisterAttribute

구현

IJavaObject IJavaPeerable IDisposable

설명

InputConnection 인터페이스는 입력을 InputMethod 수신하는 애플리케이션으로의 통신 채널입니다. 커서 주위의 텍스트를 읽고, 텍스트 상자에 텍스트를 커밋하고, 원시 키 이벤트를 애플리케이션에 보내는 등의 작업을 수행하는 데 사용됩니다.

API 수준 android.os.Build.VERSION_CODES#N부터 시스템은 애플리케이션이 이 클래스를 직접 구현하지만 다음 방법 중 하나 이상이 구현되지 않는 상황을 처리할 수 있습니다.

<에 도입 된 ul><li.android.os.Build.VERSION_CODES#GINGERBREAD<>#getSelectedText(int)에 도입 된 android.os.Build.VERSION_CODES#GINGERBREAD/li li><>#setComposingRegion(int, int)<에 도입 된 android.os.Build.VERSION_CODES#HONEYCOMB/li li><>#commitCorrection(CorrectionInfo)<에 도입 된 android.os.Build.VERSION_CODES#LOLLIPOP/li li><>#requestCursorUpdates(int)<에 도입 된 android.os.Build.VERSION_CODES#N/li li><>#deleteSurroundingTextInCodePoints(int, int)<에 도입 된 android.os.Build.VERSION_CODES#N/li li><>#getHandler()<에 도입 된 android.os.Build.VERSION_CODES#N/li li><>#closeConnection()<에 도입 된 android.os.Build.VERSION_CODES#N_MR1/li li><>#commitContent(InputContentInfo, int, Bundle)</li></ul>

<h3>IME 또는 편집<기 구현/h3>

텍스트 입력은 IME(입력 메서드 엔진)와 편집기라는 두 가지 필수 구성 요소의 시너지 효과의 결과입니다. IME는 소프트웨어 키보드, 필기 인터페이스, 이모지 팔레트, 음성 텍스트 변환 엔진 등이 될 수 있습니다. 일반적으로 지정된 Android 디바이스에 여러 IME가 설치되어 있습니다. Android에서는 IME가 확장됩니다 android.inputmethodservice.InputMethodService. IME를 만드는 방법에 대한 자세한 내용은 입력 메서드 만들기 가이드를 참조 하세요.

편집기는 텍스트를 수신하고 표시하는 구성 요소입니다. 일반적으로 인스턴스 android.widget.EditText 이지만 일부 애플리케이션은 여러 가지 이유로 자체 편집기를 구현하도록 선택할 수 있습니다. 이는 크고 복잡한 작업이며, 이 작업을 수행하는 애플리케이션은 동작이 Android의 표준 EditText 동작과 일치하는지 확인해야 합니다. 편집기에서는 IME와 상호 작용하고, 이 InputConnection 인터페이스를 통해 명령을 수신하고, 명령을 통해 android.view.inputmethod.InputMethodManager보내야 합니다. 편집기에서 먼저 고유한 입력 연결을 반환하도록 구현 android.view.View#onCreateInputConnection(EditorInfo) 해야 합니다.

고유한 IME를 구현하는 경우 이 인터페이스의 메서드를 호출하여 애플리케이션과 상호 작용해야 합니다. 처리해야 하는 특수성이 있을 수 있으므로 브라우저 및 서식 있는 텍스트 편집기를 비롯한 다양한 애플리케이션으로 IME를 테스트해야 합니다. IME가 텍스트의 유일한 변경 원본이 아닐 수 있으며, 보내는 데이터에서 가능한 한 보수적이고 받는 데이터에서 최대한 자유로워지도록 노력해야 합니다.

사용자 고유의 편집기를 구현하는 경우 IME의 BaseInputConnection 명령에 응답하기 위해 고유한 하위 클래스를 제공해야 할 수 있습니다. 가능한 한 많은 IME로 편집기를 테스트해야 합니다. 또한 입력 요구 사항이 다를 수 있으므로 CJK 언어 및 아랍어와 같은 오른쪽에서 왼쪽 언어를 비롯한 다양한 언어로 테스트해야 합니다. 특정 호출에 대해 채택해야 하는 동작이 확실하지 않은 경우 최신 Android 버전의 기본 TextView 구현을 모방하고, 텍스트 편집기 동작의 불일치가 사용자가 거의 보편적으로 나쁜 것으로 느끼는 것을 신중하게 고려하세요.

<h3>커서, 선택 및 컴퍼지션</h3>

Android에서는 커서와 선택 영역이 하나이고 동일합니다. "커서"는 크기가 0인 선택 영역의 특수한 경우일 뿐입니다. 따라서 이 설명서는 서로 교환하여 사용합니다. "커서 앞에" 동작하는 모든 메서드는 선택 영역이 있는 경우 선택 시작 전에 작동하고 "커서 뒤"로 동작하는 메서드는 선택 영역이 끝난 후 작동합니다.

편집기는 표준 버전 위젯처럼 현재 "작성 중" 지역을 추적할 수 있어야 합니다. 컴퍼지션은 특정 스타일로 android.text.Spanned#SPAN_COMPOSING표시됩니다. IME는 이를 사용하여 사용자가 현재 초점을 맞추고 있는 텍스트의 일부를 추적하고 편집기 및 를 사용하여 InputConnection#setComposingText(CharSequence, int)InputConnection#setComposingRegion(int, int)InputConnection#finishComposingText()편집기와 상호 작용할 수 있도록 합니다. 구성 영역과 선택 영역은 서로 완전히 독립적이며 IME에서 적합하게 표시되어도 사용할 수 있습니다.

에 대한 android.view.inputmethod.InputConnectionJava 설명서

이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.

속성

메서드

확장 메서드

적용 대상