KeyboardStyle QML Type

가상 키보드의 스타일링 인터페이스를 제공합니다. 더 보기...

Import Statement: import QtQuick.VirtualKeyboard.Styles
Inherits:

QtObject

속성

상세 설명

스타일 유형은 가상 키보드를 꾸미기 위해 InputPanel 에서 사용하는 스타일 정의를 제공합니다.

디자인 크기는 가상 키보드의 화면 비율을 지정합니다. 스타일은 키보드의 실제 높이와 디자인 높이에서 계산된 scaleHint 에 따라 확장할 수 있습니다.

속성 문서

alternateKeysListBackground : Component

대체 키 목록 배경의 템플릿입니다.


alternateKeysListBottomMargin : real

대체 키 목록 패널의 하단 여백입니다.


alternateKeysListDelegate : Component

대체 키 목록 항목의 템플릿입니다.

참고: 델리게이트는 ListView.


alternateKeysListHighlight : Component

대체 키 목록 하이라이트용 템플릿입니다.

참고: 델리게이트는 ListView.highlight 로 사용됩니다.


alternateKeysListItemHeight : real

대체 키 목록 항목의 높이입니다.


alternateKeysListItemWidth : real

대체 키 목록 항목의 너비입니다.


alternateKeysListLeftMargin : real

대체 키 목록 패널의 왼쪽 여백.


alternateKeysListRightMargin : real

대체 키 목록 패널의 오른쪽 여백.


alternateKeysListTopMargin : real

대체 키 목록 패널의 상단 여백입니다.


backspaceKeyPanel : Component

백스페이스 키의 템플릿입니다.

참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.


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 의 하단 사이의 픽셀 수입니다.


enterKeyPanel : Component

입력 키의 템플릿.

참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.


fullScreenInputBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력의 배경에 대한 델리게이트를 보유합니다.

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


fullScreenInputColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력 필드의 텍스트 색을 보유합니다.

기본 색은 검은색입니다.

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


fullScreenInputContainerBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력 컨테이너의 배경에 대한 델리게이트를 보유합니다.

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


fullScreenInputCursor : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력 필드의 커서에 대한 델리게이트를 보유합니다.

델리게이트는 전체 화면 입력 필드에 정의된 parent.blinkStatus 속성에 따라 커서 표시 여부를 토글해야 합니다. 예를 들어:

fullScreenInputCursor: Rectangle {
    width: 1
    color: "#000"
    visible: parent.blinkStatus
}

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


fullScreenInputFont : font [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력 필드에 대해 font 을 보유합니다.

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


fullScreenInputMargins : real [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력 필드 주변의 여백을 유지합니다.

기본값은 0 입니다.

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


fullScreenInputPadding : real [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력 콘텐츠 주변의 패딩을 유지합니다.

기본값은 0 입니다.

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


fullScreenInputPasswordCharacter : string [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력 필드에 대한 암호 마스크 문자를 보유합니다.

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


fullScreenInputSelectedTextColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력 필드에 대해 선택된 텍스트 색을 보유합니다.

기본 색은 fullScreenInputColor 로 설정되어 있습니다.

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


fullScreenInputSelectionColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

이 속성은 전체 화면 입력 필드에 대한 선택 색을 유지합니다.

기본 색은 반투명 검정색입니다.

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


functionPopupListBackground : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

함수 팝업 목록 배경의 템플릿.

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


functionPopupListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

함수 목록 항목의 템플릿.

참고: 델리게이트는 ListView.

항목에 다음 속성을 사용할 수 있습니다:

  • keyboardFunction - 현재 항목의 키보드 함수.

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


functionPopupListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

함수 팝업 목록 강조 표시용 템플릿에 도입되었습니다.

참고: 델리게이트는 ListView.highlight 로 사용됩니다.

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


handwritingKeyPanel : Component

필기 모드 키의 템플릿입니다.

참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.


hideKeyPanel : Component

숨기기 키의 템플릿입니다.

참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.


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)로 표시됩니다.


languageKeyPanel : Component

언어 키의 템플릿입니다.

참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.


languageListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

이 속성은 언어 목록 보기에 추가되는 항목에 적용할 전환을 보유합니다.

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


languageListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

언어 목록 배경의 템플릿.

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


languageListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

언어 목록 항목의 템플릿에 도입되었습니다.

참고: 델리게이트는 ListView.

참고: 델리게이트는 SelectionListItem 유형에 기반해야 합니다.

항목에 사용할 수 있는 속성은 다음과 같습니다:

  • displayName 언어의 표시 이름.

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


languageListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

언어 목록 강조 표시 템플릿에 도입되었습니다.

참고: 델리게이트는 ListView.highlight 로 사용됩니다.

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


languageListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

이 속성은 언어 목록 보기에서 제거된 항목에 적용할 전환을 보유합니다.

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


언어 팝업 목록 활성화: bool [since QtQuick.VirtualKeyboard.Styles 2.1]

이 속성은 언어 키를 클릭할 때 팝업 목록을 표시할지 여부를 결정합니다. 이 속성이 false 인 경우 언어 키를 클릭하면 사용 가능한 언어가 한 번에 하나씩 순환됩니다.

기본값은 false 입니다.

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


modeKeyPanel : Component

일반 모드 키용 템플릿.

이 템플릿은 상태가 켜지거나 꺼질 수 있는 키의 시각화를 제공합니다. 이 템플릿은 상태에 관계없이 키 레이블이 동일하게 유지되는 상황에서 사용됩니다.

현재 상태는 control.mode 속성에서 확인할 수 있습니다.

참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.


탐색 하이라이트 항목의 템플릿입니다.

이 항목은 화살표 키 탐색 모드에서 키보드의 탐색 초점을 강조 표시하는 데 사용됩니다.

이 항목은 일반적으로 대비가 높은 테두리가 있는 투명한 직사각형입니다.

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


popupListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

이 속성은 팝업 목록 보기에 추가되는 항목에 적용할 전환을 유지합니다.

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


popupListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

팝업 목록 배경의 템플릿.

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


popupListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

팝업 목록 항목의 템플릿.

참고: 델리게이트는 ListView 에서 사용됩니다.

참고: 델리게이트는 SelectionListItem 유형을 기반으로 해야 합니다.

항목에 다음 속성을 사용할 수 있습니다:

  • display 현재 항목의 텍스트를 표시합니다.
  • wordCompletionLength 단어 완성 길이 - 표시 텍스트의 끝에서 측정한 길이입니다.
  • dictionary 단어의 사전 유형은 QVirtualKeyboardSelectionListModel::DictionaryType 을 참조하세요.
  • canRemoveSuggestion 단어가 사전에서 제거될 수 있는지 여부를 나타내는 부울입니다.

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


popupListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

팝업 목록 하이라이트의 템플릿입니다.

참고: 델리게이트는 ListView.highlight 로 사용됩니다.

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


popupListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

이 속성은 팝업 목록 보기에서 제거된 항목에 적용할 전환을 보유합니다.

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


scaleHint : real [read-only]

키보드 스타일 눈금 힌트. 이 값은 keyboardHeightkeyboardDesignHeight 로 나누어 결정됩니다. 모든 픽셀 치수는 이 값에 비례해야 합니다.


selectionHandle : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

이 항목은 텍스트 선택 영역의 경계를 표시하고 선택 영역의 시작 또는 끝을 대화형으로 이동할 수 있도록 하는 데 사용됩니다. 시작과 끝 선택 모두에 동일한 항목이 사용됩니다.

선택 핸들은 현재 애플리케이션 기반 통합 방식에서만 지원됩니다.

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


selectionListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 1.3]

이 속성은 선택 목록 보기에 추가된 항목에 적용할 전환을 보유합니다.

이 속성은 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 [since QtQuick.VirtualKeyboard.Styles 1.3]

이 속성은 선택 목록 보기에서 제거된 항목에 적용할 전환을 보유합니다.

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


shiftKeyPanel : Component

시프트 키의 템플릿입니다.

참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.


spaceKeyPanel : Component

스페이스 키의 템플릿입니다.

참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.


symbolKeyPanel : Component

기호 모드 키의 템플릿입니다.

참고: 델리게이트는 KeyPanel 유형을 기반으로 해야 합니다.


traceCanvasDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

추적 객체를 렌더링하기 위한 템플릿입니다.

참고: 델리게이트는 TraceCanvas 타입을 기반으로 해야 합니다.

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


traceInputKeyPanelDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

추적 입력 키의 템플릿입니다.

참고: 델리게이트는 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.