Back to Qt.io
Contact Us Blog Download Qt

BaseKey QML Type

모든 키 유형에 대한 공통 부모입니다. 더 보기...

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

Item

Inherited By:

BackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, HideKeyboardKey, Key, and ShiftKey

속성

신호

상세 설명

BaseKey는 키보드 레이아웃의 모든 키에 공통적으로 사용되는 유형입니다.

이 유형은 레이아웃에 직접 사용해서는 안 됩니다. 대신 Key 또는 EnterKey 같은 특수 키 유형을 사용해야 합니다.

속성 문서

active : bool

이 속성은 키의 활성 상태를 유지합니다.

이 속성은 키를 누르면 자동으로 true로 설정됩니다.


alternativeKeys : var

대체 키 목록을 설정합니다.

이 속성은 문자열 또는 문자열 목록으로 설정할 수 있습니다. 값이 문자열인 경우 대체 키는 해당 문자열의 개별 문자로 표시됩니다. 값이 문자열 목록인 경우에는 목록이 대신 사용됩니다.

대체 키는 이 속성이 설정된 키를 길게 누르면 사용자에게 표시됩니다.

참고: 대체 키에 text 키가 포함된 경우 effectiveAlternativeKeys 에서 필터링되고 그 위치가 강조 표시된 항목의 표시기로 대신 사용됩니다.

기본값은 빈 목록입니다.


displayAlternativeKeys : var [since QtQuick.VirtualKeyboard 6.2]

이 속성을 사용하면 대체 키 보기에서 사용자에게 표시되는 키 문자열 목록을 재정의할 수 있습니다.

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


displayText : string

표시 텍스트를 설정합니다.

이 문자열은 키보드 레이아웃에 렌더링됩니다.

기본값은 키 텍스트입니다.


effectiveAlternativeKeys : var [read-only, since QtQuick.VirtualKeyboard 2.0]

이 속성에는 사용자에게 표시되는 유효한 대체 키가 포함됩니다.

목록에는 text 항목을 제외한 alternativeKeys 의 항목이 포함됩니다.

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


effectiveAlternativeKeysHighlightIndex : int [read-only, since QtQuick.VirtualKeyboard 2.0]

이 속성에는 effectiveAlternativeKeys 에서 강조 표시된 항목의 인덱스가 포함됩니다.

인덱스는 alternativeKeys 에서 text 키의 인덱스로부터 계산됩니다.

예를 들어 대체 키에 "çcċčć"가 포함되어 있고 text 키가 "c"인 경우 이 인덱스는 1이 되고 사용자에게 표시되는 유효한 대체 키는 "ç[ċ]čć"가 됩니다.

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


functionKey : bool

기능 키 속성을 설정합니다.

기본값은 거짓입니다.


highlighted : bool

키의 강조 표시 상태를 설정합니다.

기본값은 false입니다.


key : int

입력 메서드 처리를 위한 키 코드를 설정합니다.

기본값은 Qt.Key_unknown입니다.


keyPanelDelegate : alias

키의 키 패널 델리게이트를 설정합니다.

이 속성은 키 데코레이션에 필수적입니다. 키 패널 델리게이트가 없으면 키가 보이지 않습니다. 이 속성은 상속된 키 유형에 할당되어야 합니다.


keyType : int [since QtQuick.VirtualKeyboard 6.1]

Key 특수 키의 유형을 지정합니다. 가능한 값은 {QtVirtualKeyboard::KeyType}{키 유형 열거}로 정의됩니다.

예를 들어 SpaceKey 은 이 값을 QtVirtualKeyboard.KeyType.SpaceKey 로 설정합니다.

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


noKeyEvent : bool [since QtQuick.VirtualKeyboard 1.3]

이 프로퍼티는 키가 입력 메서드 처리를 위해 키 이벤트를 발생시킬지 여부를 제어합니다. 참이면 키 이벤트가 비활성화됩니다.

기본적으로 키가 알 수 없거나 텍스트가 비어 있지 않은 경우 키 이벤트가 발생합니다.

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


noModifier : bool [since QtQuick.VirtualKeyboard 1.3]

방출된 키에서 키 수정자를 비활성화합니다.

기본값은 false입니다.

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


pressed : bool

이 속성은 키의 눌림 상태를 유지합니다.

키가 활성화되고 활성화된 상태일 때만 눌림 상태가 참이 될 수 있습니다. 키 상태가 눌린 상태가 되면 입력 엔진에 키 다운 이벤트가 트리거됩니다. 키가 해제되면 키 업 이벤트가 트리거됩니다.


repeat : bool

키 반복 속성을 설정합니다.

반복이 활성화되면 키를 누르고 있는 동안 입력 이벤트가 반복됩니다. alternativeKeys 도 설정되어 있으면 반복을 사용하지 않아야 합니다.

기본값은 false입니다.


showPreview : bool

미리 보기 표시 속성을 설정합니다.

기본적으로 기능 키에는 문자 미리 보기 팝업이 표시되지 않습니다.


smallText : string [since QtQuick.VirtualKeyboard 2.0]

키 모서리에 렌더링되는 작은 텍스트를 설정합니다.

기본값은 유효한 대체 키의 기본 항목을 기반으로 합니다.

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


smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]

작은 텍스트의 가시성을 설정합니다.

기본값은 부모로부터 상속됩니다.

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


soundEffect : url [read-only, since QtQuick.VirtualKeyboard 1.1]

이 속성은 키를 누를 때 재생할 사운드 효과를 보유합니다.

사운드 효과는 키보드 스타일로 정의되므로 이 속성은 읽기 전용입니다.

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


text : string

입력 메서드 처리를 위한 키 텍스트를 설정합니다.

대부분의 경우 키 코드의 유니코드 표현입니다.

기본값은 빈 문자열입니다.


uppercased : bool

이 속성은 키의 대문자 상태를 유지합니다.

기본적으로 이 속성은 키보드의 대문자 상태를 반영합니다.


weight : real

키의 상대적 크기를 결정하는 키 가중치 값을 설정합니다.

레이아웃에서 키 크기를 변경하려면 이 속성을 사용합니다.

기본값은 레이아웃 계층 구조에서 키의 부모 요소에서 상속됩니다.


신호 문서

clicked()

이 신호는 키를 누를 때 트리거되어 키의 사용자 지정 처리를 허용합니다.

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


© 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.