KeyboardStyle QML Type
Provides a styling interface for the Virtual Keyboard. More...
Import Statement: | import QtQuick.VirtualKeyboard.Styles 2.0 |
Inherits: |
Properties
- 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
- handwritingKeyPanel : Component
- hideKeyPanel : Component
- keyPanel : Component
- keyboardBackground : Component
- keyboardDesignHeight : real
- keyboardDesignWidth : real
- keyboardHeight : real
- keyboardRelativeBottomMargin : real
- keyboardRelativeLeftMargin : real
- keyboardRelativeRightMargin : real
- keyboardRelativeTopMargin : real
- languageKeyPanel : Component
- modeKeyPanel : Component
- navigationHighlight : Component
- popupListAdd : Transition
- popupListBackground : Component
- popupListDelegate : Component
- popupListHighlight : Component
- popupListRemove : Transition
- scaleHint : real
- selectionHandle : Component
- selectionListAdd : Transition
- selectionListBackground : Component
- selectionListDelegate : Component
- selectionListHeight : real
- selectionListHighlight : Component
- selectionListRemove : Transition
- shiftKeyPanel : Component
- spaceKeyPanel : Component
- symbolKeyPanel : Component
- traceCanvasDelegate : Component
- traceInputKeyPanelDelegate : Component
Detailed Description
The style type provides the style definitions that are used by the InputPanel to decorate the virtual keyboard.
The design size specifies the aspect ratio of the virtual keyboard. Styles are scalable according to scaleHint, which is calculated from the keyboard's actual height and design height.
Property Documentation
alternateKeysListBackground : Component |
Template for the alternative keys list background.
alternateKeysListDelegate : Component |
Template for the alternative keys list item.
Note: The delegate is used as ListView.delegate
.
alternateKeysListHighlight : Component |
Template for the alternative keys list highlight.
Note: The delegate is used as ListView.highlight
.
backspaceKeyPanel : Component |
Template for the backspace key.
Note: The delegate must be based on the KeyPanel type.
characterPreviewDelegate : Component |
Template for the character preview popup.
If the delegate contains the text
property, the property is updated with the display text when the component becomes active.
property string text
Example:
characterPreviewDelegate: Item { property string text id: characterPreview Rectangle { id: characterPreviewBackground anchors.fill: parent ... Text { text: characterPreview.text anchors.fill: parent ... } } }
Number of pixels between the top of each key and the bottom of the characterPreviewDelegate.
enterKeyPanel : Component |
Template for the enter key.
Note: The delegate must be based on the KeyPanel type.
handwritingKeyPanel : Component |
Template for the handwriting mode key.
Note: The delegate must be based on the KeyPanel type.
hideKeyPanel : Component |
Template for the hide key.
Note: The delegate must be based on the KeyPanel type.
keyPanel : Component |
Template for the regular keys.
Note: The delegate must be based on the KeyPanel type.
Example:
keyPanel: KeyPanel { Rectangle { anchors.fill: parent ... Text { anchors.fill: parent text: control.displayText ... } } }
keyboardBackground : Component |
Template for the keyboard background.
Example:
keyboardBackground: Rectangle {
color: "black"
}
The distance between the bottom-most keys and the bottom edge of the keyboard container, expressed as a percentage (0.0
- 1.0
) of the keyboard's height.
The distance between the left-most keys and the left edge of the keyboard, expressed as a percentage (0.0
- 1.0
) of the keyboard's width.
The distance between the right-most keys and the right edge of the keyboard, expressed as a percentage (0.0
- 1.0
) of the keyboard's width.
This value is proportional to the keyboard's width.
The distance between the top-most keys and the top edge of the keyboard, expressed as a percentage (0.0
- 1.0
) of the keyboard's height.
languageKeyPanel : Component |
Template for the language key.
Note: The delegate must be based on the KeyPanel type.
modeKeyPanel : Component |
Template for the generic mode key.
This template provides a visualization of the key in which the state can be on or off. This template is used in situations where the key label will remain the same regardless of status.
The current state is available in the control.mode
property.
Note: The delegate must be based on the KeyPanel type.
navigationHighlight : Component |
Template for the navigation highlight item.
This item is used in arrow-key-navigation mode to highlight the navigation focus on the keyboard.
The item is typically a transparent rectangle with a high contrast border.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 1.1.
popupListAdd : Transition |
This property holds the transition to apply to items that are added to the popup list view.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.
popupListBackground : Component |
Template for the popup list background.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.
popupListDelegate : Component |
Template for the popup list item.
Note: The delegate is used as ListView.delegate
.
Note: The delegate must be based on the SelectionListItem type.
The following properties are available to the item:
display
Display text for the current item.wordCompletionLength
Word completion length measured from the end of the display text.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.
popupListHighlight : Component |
Template for the popup list highlight.
Note: The delegate is used as ListView.highlight
.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.
popupListRemove : Transition |
This property holds the transition to apply to items that are removed from the popup list view.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.
The keyboard style scale hint. This value is determined by the physical size and the design size of the keyboard. All pixel dimensions must be proportional to this value.
selectionHandle : Component |
This item is used to indicate where the bounds of the text selection is and to be able to interactively move the start or end of the selection. The same item is used for both start and end selection.
Selection handles are currently only supported for the application-based integration method.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.
selectionListAdd : Transition |
This property holds the transition to apply to items that are added to the selection list view.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 1.3.
selectionListBackground : Component |
Template for the selection list background.
selectionListDelegate : Component |
Template for the selection list item.
Note: The delegate is used as ListView.delegate
.
Note: The delegate must be based on the SelectionListItem type.
The following properties are available to the item:
display
Display text for the current item.wordCompletionLength
Word completion length measured from the end of the display text.
selectionListHighlight : Component |
Template for the selection list highlight.
Note: The delegate is used as ListView.highlight
.
selectionListRemove : Transition |
This property holds the transition to apply to items that are removed from the selection list view.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 1.3.
shiftKeyPanel : Component |
Template for the shift key.
Note: The delegate must be based on the KeyPanel type.
spaceKeyPanel : Component |
Template for the space key.
Note: The delegate must be based on the KeyPanel type.
symbolKeyPanel : Component |
Template for the symbol mode key.
Note: The delegate must be based on the KeyPanel type.
traceCanvasDelegate : Component |
Template for rendering a Trace object.
Note: The delegate must be based on the TraceCanvas type.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.
traceInputKeyPanelDelegate : Component |
Template for the trace input key.
Note: The delegate must be based on the TraceInputKeyPanel type.
This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.
© 2017 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.