QInputMethod Class

멤버 기능 문서

[slot] void QInputMethod::commit()

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

[slot] void QInputMethod::hide()

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

일반적으로 애플리케이션은 이 함수를 호출할 필요가 없으며, 텍스트 편집기가 포커스를 잃으면 키보드가 자동으로 닫혀야 합니다(예: 상위 보기가 닫힐 때).

QRectF QInputMethod::inputItemRectangle() const

입력 항목의 지오메트리를 입력 항목 좌표로 반환합니다.

setInputItemRectangle()도 참조하세요 .

QTransform QInputMethod::inputItemTransform() const

입력 항목 좌표에서 창 좌표로의 변환을 반환합니다.

setInputItemTransform()도 참조하세요 .

[slot] void QInputMethod::invokeAction(QInputMethod::Action a, int cursorPosition)

현재 작성 중인 단어를 사용자가 탭할 때 입력 항목에 의해 호출되며, a 동작과 주어진 cursorPosition 으로 표시됩니다. 입력 메서드는 종종 이 정보를 사용하여 사용자에게 더 많은 단어 제안을 제공합니다.

[static] QVariant QInputMethod::queryFocusObject(Qt::InputMethodQuery query, const QVariant &argument)

매개변수 argument 를 사용하여 현재 포커스 객체에 query 를 전송하고 결과를 반환합니다.

[slot] void QInputMethod::reset()

입력 메소드 상태를 재설정합니다. 예를 들어, 텍스트 편집기는 일반적으로 텍스트를 삽입하기 전에 이 메서드를 호출하여 위젯이 텍스트를 받아들일 준비를 합니다.

입력 메서드는 포커스된 편집기가 변경되면 자동으로 재설정됩니다.

void QInputMethod::setInputItemRectangle(const QRectF &rect)

입력 항목의 지오메트리를 입력 항목 좌표로 rect 로 설정합니다. 항목이 씬 내에서 이동하거나 초점이 변경될 때마다 QQuickCanvas와 같은 초점이 맞춰진 창에서 업데이트해야 합니다.

inputItemRectangle()도 참조하십시오 .

void QInputMethod::setInputItemTransform(const QTransform &transform)

입력 항목 좌표에서 창 좌표로의 변환을 transform 으로 설정합니다. 항목 변환은 항목이 장면 내에서 이동할 때마다 QQuickCanvas와 같이 초점이 맞춰진 창에서 업데이트해야 합니다.

inputItemTransform()도 참조하십시오 .

void QInputMethod::setVisible(bool visible)

키보드 표시 여부를 제어합니다. show ()( visible 이 true 인 경우) 또는 hide()( visible 이 false 인 경우)를 호출하는 것과 동일합니다.

isVisible(), show() 및 hide()도 참조하세요 .

[slot] void QInputMethod::show()

가상 키보드를 열도록 요청합니다. 플랫폼에서 가상 키보드를 제공하지 않으면 표시 여부가 거짓으로 유지됩니다.

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

[slot] void QInputMethod::update(Qt::InputMethodQueries queries)

에디터의 입력 방법 쿼리 속성에 상태 변경이 있을 때 입력 항목에서 호출하여 플랫폼 입력 방법에 알립니다. 함수를 호출할 때 queries 매개 변수를 사용하여 변경된 사항을 알려야 하며, 어떤 입력 메서드가 QInputMethodQueryEvent 으로 관심 있는 속성에 대한 쿼리를 수행할 수 있는지 알려야 합니다.

특히 커서 위치가 변경될 때마다 업데이트를 호출하는 것은 주변 텍스트 및 텍스트 선택과 같은 다른 쿼리 속성도 변경되는 경우가 많으므로 중요합니다. 커서 위치와 함께 자주 변경되는 속성은 편의를 위해 Qt::ImQueryInput 값으로 그룹화했습니다.