BaseKey QML Type

모든 키 유형의 공통 상위 클래스. 더 보기...

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

속성

• active : bool
• alternativeKeys : var
• displayAlternativeKeys : var (since 6.2)
• displayText : string
• effectiveAlternativeKeys : var (since QtQuick.VirtualKeyboard 2.0)
• effectiveAlternativeKeysHighlightIndex : int (since QtQuick.VirtualKeyboard 2.0)
• functionKey : bool
• highlighted : bool
• key : int
• keyPanelDelegate : alias
• keyType : int (since 6.1)
• noKeyEvent : bool (since QtQuick.VirtualKeyboard 1.3)
• noModifier : bool (since QtQuick.VirtualKeyboard 1.3)
• pressed : bool
• repeat : bool
• showPreview : bool
• smallText : string (since QtQuick.VirtualKeyboard 2.0)
• smallTextVisible : bool (since QtQuick.VirtualKeyboard 2.0)
• soundEffect : url (since QtQuick.VirtualKeyboard 1.1)
• text : string
• uppercased : bool
• weight : real

신호

• clicked()

상세 설명

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

이 타입은 레이아웃에서 직접 사용해서는 안 됩니다. 대신 Key나 EnterKey 와 같은 특화된 키 타입을 사용해야 합니다.

속성 문서

active : bool

이 속성은 키의 활성화 상태를 나타냅니다.

이 속성은 키가 눌리면 자동으로 true로 설정됩니다.

alternativeKeys : var

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

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

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

기본값은 빈 리스트입니다.

displayAlternativeKeys : var [since 6.2]

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

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

displayText : string

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

이 문자열은 키보드 레이아웃에 표시됩니다.

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

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

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

이 목록에는 ' alternativeKeys '에 포함된 항목 중 ' text ' 항목을 제외한 항목들이 포함되어 있습니다.

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

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

기본값은 false입니다.

highlighted : bool

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

기본값은 false입니다.

key : int

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

기본값은 Qt.Key_unknown입니다.

keyPanelDelegate : alias

키에 대한 키 패널 델리게이트를 설정합니다.

이 속성은 키 장식에 필수적입니다. 키 패널 델리게이트가 없으면 키가 표시되지 않습니다. 이 속성은 상속받은 키 유형에서 할당되어야 합니다.

keyType : int [since 6.1]

Key 전용 키의 유형입니다. 가능한 값은 {QtVirtualKeyboard::KeyType}{key type 열거형}에 정의되어 있습니다.

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

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

noKeyEvent : bool [since QtQuick.VirtualKeyboard 1.3]

이 속성은 키가 입력 방식 처리를 위해 키 이벤트를 발생시킬지 여부를 제어합니다. true로 설정하면 키 이벤트가 비활성화됩니다.

기본적으로, 키가 ‘unknown’ 상태가 아니거나 텍스트가 비어 있지 않은 경우 키 이벤트가 발생합니다.

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

noModifier : bool [since QtQuick.VirtualKeyboard 1.3]

발생된 키에 대한 키 수정자를 비활성화합니다.

기본값은 false입니다.

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

pressed : bool

이 속성은 키의 눌림 상태를 저장합니다.

키가 활성화되어 있고 활성 상태일 때만 눌림 상태가 true가 될 수 있습니다. 키 상태가 눌림 상태가 되면 입력 엔진에 대해 키 다운 이벤트가 발생합니다. 키를 놓으면 키 업 이벤트가 발생합니다.

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

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

이 속성을 사용하여 레이아웃 내 키의 크기를 변경할 수 있습니다.

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

Signal 문서

clicked()

이 신호는 키가 눌릴 때 트리거되며, 이를 통해 키에 대한 사용자 정의 처리가 가능합니다.