KeyboardStyle QML Type
가상 키보드의 스타일링 인터페이스를 제공합니다. 더 보기...
Import Statement: | import QtQuick.VirtualKeyboard.Styles |
Inherits: |
속성
- alternateKeysListBackground : Component
- alternateKeysListBottomMargin : real
- alternateKeysListDelegate : Component
- alternateKeysListHighlight : Component
- alternateKeysListItemHeight : real
- alternateKeysListItemWidth : real
- alternateKeysListLeftMargin : real
- alternateKeysListRightMargin : real
- alternateKeysListTopMargin : real
- backspaceKeyPanel : Component
- characterPreviewDelegate : Component
- characterPreviewMargin : real
- enterKeyPanel : Component
- fullScreenInputBackground : Component
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputColor : color
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputContainerBackground : Component
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputCursor : Component
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputFont : font
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputMargins : real
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputPadding : real
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputPasswordCharacter : string
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputSelectedTextColor : color
(since QtQuick.VirtualKeyboard.Styles 2.2)
- fullScreenInputSelectionColor : color
(since QtQuick.VirtualKeyboard.Styles 2.2)
- functionPopupListBackground : Component
(since QtQuick.VirtualKeyboard.Styles 6.2)
- functionPopupListDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 6.2)
- functionPopupListHighlight : Component
(since QtQuick.VirtualKeyboard.Styles 6.2)
- handwritingKeyPanel : Component
- hideKeyPanel : Component
- keyPanel : Component
- keyboardBackground : Component
- keyboardDesignHeight : real
- keyboardDesignWidth : real
- keyboardHeight : real
- keyboardRelativeBottomMargin : real
- keyboardRelativeLeftMargin : real
- keyboardRelativeRightMargin : real
- keyboardRelativeTopMargin : real
- languageKeyPanel : Component
- languageListAdd : Transition
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languageListBackground : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languageListDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languageListHighlight : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languageListRemove : Transition
(since QtQuick.VirtualKeyboard.Styles 2.1)
- languagePopupListEnabled : bool
(since QtQuick.VirtualKeyboard.Styles 2.1)
- modeKeyPanel : Component
- navigationHighlight : Component
(since QtQuick.VirtualKeyboard.Styles 1.1)
- popupListAdd : Transition
(since QtQuick.VirtualKeyboard.Styles 2.1)
- popupListBackground : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- popupListDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- popupListHighlight : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- popupListRemove : Transition
(since QtQuick.VirtualKeyboard.Styles 2.1)
- scaleHint : real
- selectionHandle : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- selectionListAdd : Transition
(since QtQuick.VirtualKeyboard.Styles 1.3)
- selectionListBackground : Component
- selectionListDelegate : Component
- selectionListHeight : real
- selectionListHighlight : Component
- selectionListRemove : Transition
(since QtQuick.VirtualKeyboard.Styles 1.3)
- shiftKeyPanel : Component
- spaceKeyPanel : Component
- symbolKeyPanel : Component
- traceCanvasDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
- traceInputKeyPanelDelegate : Component
(since QtQuick.VirtualKeyboard.Styles 2.1)
상세 설명
스타일 유형은 가상 키보드를 꾸미기 위해 InputPanel 에서 사용하는 스타일 정의를 제공합니다.
디자인 크기는 가상 키보드의 화면 비율을 지정합니다. 스타일은 키보드의 실제 높이와 디자인 높이에서 계산된 scaleHint 에 따라 확장할 수 있습니다.
속성 문서
alternateKeysListBackground : Component |
대체 키 목록 배경의 템플릿입니다.
alternateKeysListBottomMargin : real |
대체 키 목록 패널의 하단 여백입니다.
alternateKeysListHighlight : Component |
대체 키 목록 하이라이트용 템플릿입니다.
참고: 델리게이트는 ListView.highlight
로 사용됩니다.
alternateKeysListItemHeight : real |
대체 키 목록 항목의 높이입니다.
alternateKeysListItemWidth : real |
대체 키 목록 항목의 너비입니다.
alternateKeysListLeftMargin : real |
대체 키 목록 패널의 왼쪽 여백.
alternateKeysListRightMargin : real |
대체 키 목록 패널의 오른쪽 여백.
alternateKeysListTopMargin : real |
대체 키 목록 패널의 상단 여백입니다.
characterPreviewDelegate : Component |
문자 미리 보기 팝업의 템플릿입니다.
델리게이트에 text
속성이 포함된 경우 컴포넌트가 활성화되면 속성이 표시 텍스트로 업데이트됩니다.
property string text
예시:
characterPreviewDelegate: Item { property string text id: characterPreview Rectangle { id: characterPreviewBackground anchors.fill: parent ... Text { text: characterPreview.text anchors.fill: parent ... } } }
characterPreviewMargin : real |
각 키의 상단과 characterPreviewDelegate 의 하단 사이의 픽셀 수입니다.
fullScreenInputBackground : Component |
이 속성은 전체 화면 입력의 배경에 대한 델리게이트를 보유합니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
fullScreenInputColor : color |
이 속성은 전체 화면 입력 필드의 텍스트 색을 보유합니다.
기본 색은 검은색입니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
fullScreenInputContainerBackground : Component |
이 속성은 전체 화면 입력 컨테이너의 배경에 대한 델리게이트를 보유합니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
fullScreenInputCursor : Component |
이 속성은 전체 화면 입력 필드의 커서에 대한 델리게이트를 보유합니다.
델리게이트는 전체 화면 입력 필드에 정의된 parent.blinkStatus
속성에 따라 커서 표시 여부를 토글해야 합니다. 예를 들어:
fullScreenInputCursor: Rectangle { width: 1 color: "#000" visible: parent.blinkStatus }
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
fullScreenInputFont : font |
이 속성은 전체 화면 입력 필드에 대해 font
을 보유합니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
fullScreenInputMargins : real |
이 속성은 전체 화면 입력 필드 주변의 여백을 유지합니다.
기본값은 0
입니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
fullScreenInputPadding : real |
이 속성은 전체 화면 입력 콘텐츠 주변의 패딩을 유지합니다.
기본값은 0
입니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
fullScreenInputPasswordCharacter : string |
이 속성은 전체 화면 입력 필드에 대한 암호 마스크 문자를 보유합니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
fullScreenInputSelectedTextColor : color |
이 속성은 전체 화면 입력 필드에 대해 선택된 텍스트 색을 보유합니다.
기본 색은 fullScreenInputColor
로 설정되어 있습니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
fullScreenInputSelectionColor : color |
이 속성은 전체 화면 입력 필드에 대한 선택 색을 유지합니다.
기본 색은 반투명 검정색입니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.2에 도입되었습니다.
functionPopupListBackground : Component |
함수 팝업 목록 배경의 템플릿.
이 속성은 QtQuick.VirtualKeyboard.Styles 6.2에 도입되었습니다.
functionPopupListDelegate : Component |
함수 목록 항목의 템플릿.
참고: 델리게이트는 ListView.
항목에 다음 속성을 사용할 수 있습니다:
keyboardFunction
- 현재 항목의 키보드 함수.
이 속성은 QtQuick.VirtualKeyboard.Styles 6.2에 도입되었습니다.
functionPopupListHighlight : Component |
함수 팝업 목록 강조 표시용 템플릿에 도입되었습니다.
참고: 델리게이트는 ListView.highlight
로 사용됩니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 6.2에 도입되었습니다.
keyPanel : Component |
일반 키용 템플릿입니다.
참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.
예시:
keyPanel: KeyPanel { Rectangle { anchors.fill: parent ... Text { anchors.fill: parent text: control.displayText ... } } }
keyboardBackground : Component |
예: 키보드 배경용 템플릿입니다.
예시:
keyboardBackground: Rectangle {
color: "black"
}
keyboardDesignHeight : real |
키보드의 디자인 높이입니다.
keyboardDesignWidth : real |
키보드의 디자인 너비입니다.
keyboardHeight : real |
키보드의 현재 높이입니다.
keyboardRelativeBottomMargin : real |
가장 아래쪽 키와 키보드 컨테이너의 아래쪽 가장자리 사이의 거리로, 키보드 높이의 백분율(0.0
- 1.0
)로 표시됩니다.
keyboardRelativeLeftMargin : real |
가장 왼쪽 키와 키보드의 왼쪽 가장자리 사이의 거리로, 키보드 너비의 백분율(0.0
- 1.0
)로 표시됩니다.
keyboardRelativeRightMargin : real |
가장 오른쪽 키와 키보드의 오른쪽 가장자리 사이의 거리로, 키보드 너비의 백분율(0.0
- 1.0
)로 표시됩니다.
이 값은 키보드 너비에 비례합니다.
keyboardRelativeTopMargin : real |
가장 위쪽 키와 키보드 위쪽 가장자리 사이의 거리로, 키보드 높이의 백분율(0.0
- 1.0
)로 표시됩니다.
languageListAdd : Transition |
이 속성은 언어 목록 보기에 추가되는 항목에 적용할 전환을 보유합니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
languageListBackground : Component |
언어 목록 배경의 템플릿.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
languageListDelegate : Component |
언어 목록 항목의 템플릿에 도입되었습니다.
참고: 델리게이트는 ListView.
참고: 델리게이트는 SelectionListItem 유형에 기반해야 합니다.
항목에 사용할 수 있는 속성은 다음과 같습니다:
displayName
언어의 표시 이름.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
languageListHighlight : Component |
언어 목록 강조 표시 템플릿에 도입되었습니다.
참고: 델리게이트는 ListView.highlight
로 사용됩니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
languageListRemove : Transition |
이 속성은 언어 목록 보기에서 제거된 항목에 적용할 전환을 보유합니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
언어 팝업 목록 활성화: bool |
이 속성은 언어 키를 클릭할 때 팝업 목록을 표시할지 여부를 결정합니다. 이 속성이 false
인 경우 언어 키를 클릭하면 사용 가능한 언어가 한 번에 하나씩 순환됩니다.
기본값은 false
입니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
modeKeyPanel : Component |
일반 모드 키용 템플릿.
이 템플릿은 상태가 켜지거나 꺼질 수 있는 키의 시각화를 제공합니다. 이 템플릿은 상태에 관계없이 키 레이블이 동일하게 유지되는 상황에서 사용됩니다.
현재 상태는 control.mode
속성에서 확인할 수 있습니다.
참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.
navigationHighlight : Component |
탐색 하이라이트 항목의 템플릿입니다.
이 항목은 화살표 키 탐색 모드에서 키보드의 탐색 초점을 강조 표시하는 데 사용됩니다.
이 항목은 일반적으로 대비가 높은 테두리가 있는 투명한 직사각형입니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 1.1에 도입되었습니다.
popupListAdd : Transition |
이 속성은 팝업 목록 보기에 추가되는 항목에 적용할 전환을 유지합니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
popupListBackground : Component |
팝업 목록 배경의 템플릿.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
popupListDelegate : Component |
팝업 목록 항목의 템플릿.
참고: 델리게이트는 ListView 에서 사용됩니다.
참고: 델리게이트는 SelectionListItem 유형을 기반으로 해야 합니다.
항목에 다음 속성을 사용할 수 있습니다:
display
현재 항목의 텍스트를 표시합니다.wordCompletionLength
단어 완성 길이 - 표시 텍스트의 끝에서 측정한 길이입니다.dictionary
단어의 사전 유형은 QVirtualKeyboardSelectionListModel::DictionaryType 을 참조하세요.canRemoveSuggestion
단어가 사전에서 제거될 수 있는지 여부를 나타내는 부울입니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
popupListHighlight : Component |
팝업 목록 하이라이트의 템플릿입니다.
참고: 델리게이트는 ListView.highlight
로 사용됩니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
popupListRemove : Transition |
이 속성은 팝업 목록 보기에서 제거된 항목에 적용할 전환을 보유합니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
scaleHint : real |
키보드 스타일 눈금 힌트. 이 값은 keyboardHeight 를 keyboardDesignHeight 로 나누어 결정됩니다. 모든 픽셀 치수는 이 값에 비례해야 합니다.
selectionHandle : Component |
이 항목은 텍스트 선택 영역의 경계를 표시하고 선택 영역의 시작 또는 끝을 대화형으로 이동할 수 있도록 하는 데 사용됩니다. 시작과 끝 선택 모두에 동일한 항목이 사용됩니다.
선택 핸들은 현재 애플리케이션 기반 통합 방식에서만 지원됩니다.
이 프로퍼티는 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
selectionListAdd : Transition |
이 속성은 선택 목록 보기에 추가된 항목에 적용할 전환을 보유합니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 1.3에 도입되었습니다.
selectionListBackground : Component |
선택 목록 배경의 템플릿입니다.
selectionListDelegate : Component |
선택 목록 항목의 템플릿입니다.
참고: 델리게이트는 ListView 에서 사용됩니다.
참고: 델리게이트는 SelectionListItem 유형을 기반으로 해야 합니다.
항목에 다음 속성을 사용할 수 있습니다:
display
현재 항목의 텍스트를 표시합니다.wordCompletionLength
단어 완성 길이 - 표시 텍스트의 끝에서 측정한 길이입니다.dictionary
단어의 사전 유형은 QVirtualKeyboardSelectionListModel::DictionaryType 을 참조하세요.canRemoveSuggestion
단어가 사전에서 제거될 수 있는지 여부를 나타내는 부울입니다.
selectionListHeight : real |
선택 목록 높이.
selectionListHighlight : Component |
선택 목록 하이라이트의 템플릿입니다.
참고: 델리게이트는 ListView.highlight
로 사용됩니다.
selectionListRemove : Transition |
이 속성은 선택 목록 보기에서 제거된 항목에 적용할 전환을 보유합니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 1.3에 도입되었습니다.
traceCanvasDelegate : Component |
추적 객체를 렌더링하기 위한 템플릿입니다.
참고: 델리게이트는 TraceCanvas 타입을 기반으로 해야 합니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
traceInputKeyPanelDelegate : Component |
추적 입력 키의 템플릿입니다.
참고: 델리게이트는 TraceInputKeyPanel 유형에 기반해야 합니다.
이 속성은 QtQuick.VirtualKeyboard.Styles 2.1에 도입되었습니다.
© 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.