InputMethod QML Type (Singleton)

QML 애플리케이션에서 ` QInputMethod `에 접근할 수 있도록 합니다. 더 보기...

참고: 이 유형은 QML 싱글톤입니다. QML 엔진 내에는 이 유형의 인스턴스가 단 하나만 존재합니다.

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• anchorRectangle : rect
• animating : bool
• cursorRectangle : rect
• inputDirection : enumeration
• inputItemClipRectangle : rect
• keyboardRectangle : rect
• locale : Locale
• visible : bool

방법

• void commit()
• void hide()
• void invokeAction(var a, int cursorPosition)
• void reset()
• void show()
• void update(enumeration queries)

상세 설명

InputMethod 싱글톤을 통해 애플리케이션의 ` QInputMethod ` 객체와 해당 객체의 모든 속성 및 슬롯에 접근할 수 있습니다. 자세한 내용은 QInputMethod 문서를 참조하십시오.

속성 문서

anchorRectangle : rect

창 좌표계에서 입력 항목의 앵커 사각형을 지정합니다.

앵커 사각형은 텍스트 선택 영역을 따라가는 데 있어, 텍스트 예측 팝업과 같은 다양한 텍스트 편집 컨트롤에서 자주 사용됩니다.

animating : bool

가상 키보드가 열리거나 닫힐 때 true입니다.

키보드가 완전히 열려 있거나 닫혀 있을 때 이 속성의 값은 false입니다. animating 가 true 이고 visibility 가 true 일 때는 키보드가 열리는 중입니다. animating 가 true 이고 visibility 가 false일 때는 키보드가 닫히는 중입니다.

cursorRectangle : rect

창 좌표계에서 입력 항목의 커서 사각형을 나타냅니다.

커서 사각형은 텍스트 예측 팝업과 같은 다양한 텍스트 편집 컨트롤에서 입력 중인 텍스트를 추적하는 데 자주 사용됩니다.

inputDirection : enumeration

현재 입력 방향.

가능한 값:

inputItemClipRectangle : rect

창 좌표계에서 입력 항목의 잘린 사각형입니다.

잘린 입력 사각형은 다양한 입력 방식(예: 가상 키보드)에서 해당 입력 방식에 할당할 수 있는 화면 영역의 크기를 결정하는 데 자주 사용됩니다.

keyboardRectangle : rect

창 좌표계에서의 가상 키보드 기하 구조.

키보드의 크기를 파악할 수 없는 경우, 이는 빈 사각형일 수 있습니다. 안드로이드의 플로팅 키보드가 바로 이러한 경우입니다.

locale : Locale

현재 입력 로케일.

visible : bool

화면상의 가상 키보드 표시 여부

가상 키보드가 없는 기기의 경우 이 속성의 값은 false로 유지됩니다.

show() 및 hide()도 참조하십시오 .

메서드 문서

void commit()

사용자가 현재 작성 중인 단어를 편집기에 반영합니다. 이 함수는 주로 텍스트 예측 기능이 있는 입력 방식이나, 문자를 입력하는 데 사용되는 문자 체계와 편집기에 실제로 추가되는 문자 체계가 다른 입력 방식에서 필요합니다. 텍스트 작성을 중단시키는 모든 종류의 동작(예: 커서가 다른 곳으로 이동하는 경우 등)은 commit() 함수를 호출하여 작성 상태를 플러시해야 합니다.

void hide()

가상 키보드를 닫도록 요청합니다.

일반적으로 텍스트 편집기가 포커스를 잃을 때(예: 상위 뷰가 닫힐 때) 키보드가 자동으로 닫히므로, 애플리케이션에서 이 함수를 호출할 필요는 없습니다.

void invokeAction(var a, int cursorPosition)

사용자가 현재 입력 중인 단어를 탭하면 입력 항목에 의해 호출되며, 이는 액션 a 및 지정된 cursorPosition 에 의해 나타납니다. 입력 방식은 종종 이 정보를 활용하여 사용자에게 더 많은 단어 제안을 제공합니다.

QInputMethod::Action도 참조하십시오 .

void reset()

입력 방식의 상태를 초기화합니다. 예를 들어, 텍스트 편집기는 일반적으로 텍스트를 삽입하기 전에 이 메서드를 호출하여 위젯이 텍스트를 받아들일 수 있도록 준비합니다.

포커스가 있는 편집기가 변경되면 입력 방식이 자동으로 재설정됩니다.

void show()

가상 키보드가 열리도록 요청합니다. 플랫폼에서 가상 키보드를 제공하지 않는 경우, 이 속성의 값은 false로 유지됩니다.

일반적으로 텍스트 편집기가 포커스를 얻으면 키보드가 자동으로 열리므로, 애플리케이션에서 이 함수를 호출할 필요는 없습니다.

void update(enumeration queries)

편집기의 입력 방식 쿼리 속성에 상태 변화가 발생했을 때, 플랫폼 입력 방식에 이를 알리기 위해 입력 항목에서 호출합니다. 이 함수를 호출할 때는 queries 매개변수를 사용하여 어떤 속성이 변경되었는지 알려야 합니다. 입력 방식은 이를 활용하여 ` QInputMethodQueryEvent`를 통해 관심 있는 속성에 대한 쿼리를 수행할 수 있습니다.

특히 커서 위치가 변경될 때마다 update()를 호출하는 것이 중요한데, 이는 주변 텍스트나 텍스트 선택 범위와 같은 다른 쿼리 속성도 함께 변경되는 경우가 많기 때문입니다. 편의상 커서 위치와 함께 자주 변경되는 속성들은 Qt::ImQueryInput 값으로 그룹화되어 있습니다.

Qt::InputMethodQueries도 참조하십시오 .