VirtualKeyboardSettings QML Type

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

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

속성

• activeLocales : list<string> (since QtQuick.VirtualKeyboard.Settings 2.0)
• arrowKeyNavigationEnabled : bool (since 6.11)
• availableLocales : list<string> (since QtQuick.VirtualKeyboard.Settings 2.0)
• closeOnReturn : bool (since 6.8)
• defaultDictionaryDisabled : bool (since 6.1)
• defaultInputMethodDisabled : bool (since 6.1)
• fullScreenMode : bool (since QtQuick.VirtualKeyboard.Settings 2.2)
• handwritingModeDisabled : bool (since 6.1)
• hwrTimeoutForAlphabetic : bool (since 6.1)
• hwrTimeoutForCjk : bool (since 6.1)
• inputMethodHints : int (since 6.1)
• keySoundVolume : real (since 6.9)
• locale : string (since QtQuick.VirtualKeyboard.Settings 2.0)
• styleName : string
• userDataPath : bool (since 6.1)
• visibleFunctionKeys : enumeration (since 6.6)
• wordCandidateList (since QtQuick.VirtualKeyboard.Settings 2.2)
  • wordCandidateList.alwaysVisible : bool (since QtQuick.VirtualKeyboard.Settings 2.2)
  • wordCandidateList.autoHideDelay : int (since QtQuick.VirtualKeyboard.Settings 2.2)

신호

• userDataReset()

상세 설명

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

설정은 현재 애플리케이션이 실행되는 동안에만 적용되며, 즉 설정 변경 사항은 영구적이지 않다는 점에 유의하십시오.

예를 들어, 애플리케이션에서 키보드 스타일을 변경하려면:

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

속성 설명

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

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

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

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

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

arrowKeyNavigationEnabled : bool [since 6.11]

이 속성을 사용하여 화살표 키 탐색을 활성화하거나 비활성화할 수 있습니다.

이 속성은 Qt 6.11에서 도입되었습니다.

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

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

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

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

closeOnReturn : bool [since 6.8]

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

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

이 속성은 Qt 6.8에서 도입되었습니다.

defaultDictionaryDisabled : bool [since 6.1]

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

이 속성은 Qt 6.1에서 도입되었습니다.

defaultInputMethodDisabled : bool [since 6.1]

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

이 속성은 Qt 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 6.1]

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

이 속성이 ` true`로 설정되면 키보드 레이아웃에서 필기 버튼이 숨겨지며, 사용자는 필기 입력 모드로 전환할 수 없습니다.

이 속성은 Qt 6.1에서 도입되었습니다.

hwrTimeoutForAlphabetic : bool [since 6.1]

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

기본적으로 타임아웃은 500밀리초입니다.

이 속성은 Qt 6.1에서 도입되었습니다.

hwrTimeoutForCjk : bool [since 6.1]

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

기본적으로 타임아웃 값은 500밀리초입니다.

이 속성은 Qt 6.1에서 도입되었습니다.

inputMethodHints : int [since 6.1]

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

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

이 속성은 Qt 6.1에서 도입되었습니다.

keySoundVolume : real [since 6.9]

이 속성은 키 사운드의 음량 레벨을 저장합니다. 레벨은 [0,1] 범위 내에 있습니다.

이 속성은 Qt 6.9에서 도입되었습니다.

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

이 속성은 키보드의 기본 로케일을 지정합니다.

로켈이 지정되지 않은 경우, 대신 시스템의 기본 로켈이 사용됩니다.

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

availableLocales 의 목록에 포함된 로케일은 지원됩니다.

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

styleName : string

이 속성은 현재 적용된 스타일을 반환합니다. 애플리케이션은 styleName에 다른 값을 설정하여 키보드 스타일을 변경할 수 있습니다.

QT_VIRTUALKEYBOARD_STYLE 환경 변수를 설정하면 시스템 전체의 키보드 스타일에 영향을 줄 수 있습니다.

userDataPath : bool [since 6.1]

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

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

이 속성은 Qt 6.1에서 도입되었습니다.

visibleFunctionKeys : enumeration [since 6.6]

이 설정은 키보드 레이아웃에서 특정 기능 키의 표시 여부를 조정하여, 해당 키를 표시하거나 숨길 수 있게 해줍니다. 기능 키가 표시되지 않을 때도 톱니바퀴 메뉴를 통해 해당 기능을 계속 사용할 수 있습니다.

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

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

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

이 속성은 Qt 6.6에서 도입되었습니다.

wordCandidateList group

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

신호 문서

userDataReset()

이 애플리케이션은 사용자 데이터가 초기화되기 전에 이 신호를 발생시켜, 가상 키보드에 사용자 데이터 디렉터리의 모든 파일을 닫아야 함을 알립니다.