VirtualKeyboardSettings QML Type

가상 키보드에 대한 설정을 제공합니다. 더 보기...

Import Statement: import QtQuick.VirtualKeyboard.Settings
Since: QtQuick.VirtualKeyboard 1.2

속성

신호

상세 설명

이 유형은 가상 키보드 설정을 구성하는 데 사용할 수 있는 VirtualKeyboardSettings 싱글톤 인스턴스를 제공합니다.

설정은 현재 애플리케이션의 수명 기간에만 적용되므로 구성 변경 사항은 영구적이지 않습니다.

예를 들어 애플리케이션에서 키보드 스타일을 변경하는 경우입니다:

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

속성 문서

activeLocales : list<string> [since QtQuick.VirtualKeyboard.Settings 2.0]

이 속성에는 가상 키보드의 활성화된 언어 목록이 포함되어 있습니다.

활성화된 언어 목록은 사용 가능한 언어의 하위 집합이며, 애플리케이션 수명 기간 동안 사용 가능한 언어 목록을 제한하는 데 사용할 수 있습니다.

언어 목록은 지정된 순서에 따라 표시됩니다.

이 프로퍼티는 QtQuick.VirtualKeyboard.Settings 2.0에 도입되었습니다.


availableLocales : list<string> [read-only, since QtQuick.VirtualKeyboard.Settings 2.0]

이 속성에는 가상 키보드에서 지원하는 언어 목록이 포함되어 있습니다.

이 목록은 읽기 전용이며 가상 키보드의 빌드 시 구성에 따라 달라집니다.

이 프로퍼티는 QtQuick.VirtualKeyboard.Settings 2.0에 도입되었습니다.


closeOnReturn : bool [since QtQuick.VirtualKeyboard.Settings 6.8]

이 속성을 사용하면 가상 키보드를 숨길 수 있습니다.

이 속성을 true 로 설정하면 Qt::Key_Enter 또는 Qt::Key_Return 키를 놓을 때 가상 키보드가 숨겨집니다. 기본값은 false 입니다.

이 속성은 QtQuick.VirtualKeyboard.Settings 6.8에 도입되었습니다.


defaultDictionaryDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

이 속성은 기본 사전을 비활성화합니다. 이 설정의 목적은 표준 사전 대신 사용자 정의 사전만 사용할 수 있도록 하는 것입니다.

이 속성은 QtQuick.VirtualKeyboard.Settings 6.1에 도입되었습니다.


defaultInputMethodDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

이 속성은 기본 입력 방법을 비활성화합니다. 이 설정의 목적은 기본 입력 방법을 일반 입력 방법으로 재정의하여 해당 기능을 비활성화할 수 있도록 하는 것입니다.

이 속성은 QtQuick.VirtualKeyboard.Settings 6.1에 도입되었습니다.


fullScreenMode : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

이 속성은 가상 키보드의 전체 화면 모드를 활성화합니다.

전체 화면 모드에서는 가상 키보드가 초점이 맞춰진 입력 필드의 내용을 키보드 상단에 위치한 전체 화면 입력 필드에 복제합니다.

예를 들어 화면 비율이 16:9보다 큰 경우 전체 화면 모드를 활성화합니다:

Binding {
    target: VirtualKeyboardSettings
    property: "fullScreenMode"
    value: (Screen.width / Screen.height) > (16.0 / 9.0)
}

이 속성은 QtQuick.VirtualKeyboard.Settings 2.2에 도입되었습니다.


handwritingModeDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

이 속성을 사용하면 시스템에서 필기 입력 모드를 사용할 수 있는 경우 이를 비활성화할 수 있습니다.

이 속성을 true 으로 설정하면 필기 버튼이 키보드 레이아웃에서 숨겨지고 사용자가 필기 입력 모드로 전환할 수 없습니다.

이 속성은 QtQuick.VirtualKeyboard.Settings 6.1에 도입되었습니다.


hwrTimeoutForAlphabetic : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

이 속성은 알파벳 언어에 대한 필기 인식 시간 제한을 설정합니다.

기본적으로 시간 제한은 500밀리초입니다.

이 속성은 QtQuick.VirtualKeyboard.Settings 6.1에 도입되었습니다.


hwrTimeoutForCjk : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

이 속성은 중국어/일본어/한국어에 대한 필기 인식 시간 제한을 설정합니다.

기본적으로 시간 제한은 500밀리초입니다.

이 프로퍼티는 QtQuick.VirtualKeyboard.Settings 6.1에 도입되었습니다.


inputMethodHints : int [since QtQuick.VirtualKeyboard.Settings 6.1]

이 속성을 사용하면 영구 입력 방법 힌트를 설정할 수 있습니다.

이 속성의 값은 입력 컨트롤의 입력 방법 힌트와 결합됩니다. 예를 들어, 예측 텍스트 입력을 비활성화하려면 이 속성을 Qt::ImhNoPredictiveText 로 설정할 수 있습니다.

이 프로퍼티는 QtQuick.VirtualKeyboard.Settings 6.1에 도입되었습니다.


locale : string [since QtQuick.VirtualKeyboard.Settings 2.0]

이 속성은 키보드의 기본 로캘을 제공합니다.

로캘을 지정하지 않으면 기본 시스템 로캘이 대신 사용됩니다.

키보드 로캘이 새 기본 로캘과 다른 경우 키보드 언어가 새 로캘을 반영하도록 즉시 변경됩니다. 로캘 설정이 올바르지 않거나 지원되는 로캘 목록에 없는 경우 해당 로캘은 무시되고 기본 설정이 대신 사용됩니다.

로캘이 availableLocales 의 목록에 포함되어 있으면 지원됩니다.

이 속성은 QtQuick.VirtualKeyboard.Settings 2.0에 도입되었습니다.


styleName : string

이 속성은 현재 스타일을 제공합니다. 응용 프로그램은 styleName을 다른 값으로 설정하여 키보드 스타일을 변경할 수 있습니다.

시스템 전체 키보드 스타일은 QT_VIRTUALKEYBOARD_STYLE 환경 변수를 설정하여 영향을 받을 수 있습니다.


userDataPath : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

이 속성은 가상 키보드 및 해당 플러그인에 대한 사용자 데이터 경로를 설정합니다.

기본적으로 사용자 데이터 경로는 GenericConfigLocation + "/qtvirtualkeyboard"로 설정됩니다.

이 속성은 QtQuick.VirtualKeyboard.Settings 6.1에 도입되었습니다.


visibleFunctionKeys : enumeration [since QtQuick.VirtualKeyboard.Settings 6.6]

이 설정은 키보드 레이아웃에서 특정 기능 키의 가시성을 조정하여 표시하거나 숨길 수 있도록 합니다. 기능 키가 보이지 않는 경우에도 기어 메뉴를 통해 해당 기능에 액세스할 수 있습니다.

이 값은 다음 플래그의 조합으로 설정할 수 있습니다:

  • QtVirtualKeyboard.KeyboardFunctionKeys.None 모든 기능 키가 숨겨짐
  • QtVirtualKeyboard.KeyboardFunctionKeys.Hide 기능 키 숨기기 표시됨
  • QtVirtualKeyboard.KeyboardFunctionKeys.Language 언어 기능 키가 표시됨
  • QtVirtualKeyboard.KeyboardFunctionKeys.All 모든 기능 키 표시

기본값은 QtVirtualKeyboard.KeyboardFunctionKeys.All 입니다.

이 속성은 QtQuick.VirtualKeyboard.Settings 6.6에 도입되었습니다.


wordCandidateList group

wordCandidateList.alwaysVisible : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

wordCandidateList.autoHideDelay : int [since QtQuick.VirtualKeyboard.Settings 2.2]

이름설명
autoHideDelay이 속성은 단어 후보 목록이 비어 있으면 숨겨지는 지연 시간(밀리초)을 정의합니다.

값이 0 인 경우 지워지면 목록이 즉시 숨겨집니다.

값이 -1 인 경우 입력 초점이 변경되거나 입력 패널이 숨겨질 때까지 목록이 표시됩니다.

기본값은 5000 밀리초입니다.

항상 표시이 속성은 단어 후보 목록을 항상 표시할지 여부를 정의합니다.

기본값은 false 입니다.

autoCommitWord이 속성은 단어 후보 목록이 단일 후보로 좁혀질 때 활성화되는 자동 커밋 기능을 사용하도록 설정합니다.

자동 커밋 기능은 단어 후보 목록에 처음에 여러 단어가 포함되어 있다가 추가 입력 후 단일 단어로 좁혀질 때 적용됩니다. 이 단어는 사용자 상호작용 없이 자동으로 선택되어 커밋됩니다.

이 속성은 기본적으로 false 로 설정되어 있습니다.

이 QML 프로퍼티는 QtQuick.VirtualKeyboard.Settings 2.2에 도입되었습니다.


신호 문서

userDataReset()

애플리케이션은 사용자 데이터가 초기화되기 전에 이 신호를 트리거하여 가상 키보드에 사용자 데이터 디렉토리에 있는 모든 파일을 닫아야 함을 알립니다.

참고: 해당 핸들러는 onUserDataReset 입니다.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.