KeyboardStyle QML 类型

为虚拟键盘提供样式化接口。 更多...

import 语句: import QtQuick.VirtualKeyboard.Styles 2.2
继承: QtObject

特性

详细描述

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.

特性文档编制

alternateKeysListBackground : Component

Template for the alternative keys list background.

alternateKeysListBottomMargin : real

Bottom margin for the alternate keys list panel.

alternateKeysListDelegate : Component

Template for the alternative keys list item.

注意: 委托用于 ListView .

alternateKeysListHighlight : Component

Template for the alternative keys list highlight.

注意: The delegate is used as ListView.highlight .

alternateKeysListItemHeight : real

Height of the alternate keys list item.

alternateKeysListItemWidth : real

Width of the alternate keys list item.

alternateKeysListLeftMargin : real

Left margin for the alternate keys list panel.

alternateKeysListRightMargin : real

Right margin for the alternate keys list panel.

alternateKeysListTopMargin : real

Top margin for the alternate keys list panel.

backspaceKeyPanel : Component

Template for the backspace key.

注意: The delegate must be based on the KeyPanel 类型。

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
																

范例:

characterPreviewDelegate: Item {
    property string text
    id: characterPreview
    Rectangle {
        id: characterPreviewBackground
        anchors.fill: parent
        ...
        Text {
            text: characterPreview.text
            anchors.fill: parent
            ...
        }
    }
}
																

characterPreviewMargin : real

Number of pixels between the top of each key and the bottom of the characterPreviewDelegate .

enterKeyPanel : Component

Template for the enter key.

注意: The delegate must be based on the KeyPanel 类型。

fullScreenInputBackground : Component

This property holds the delegate for the background of the full screen input.

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputColor : color

This property holds the text color for the full screen input field.

The default color is black.

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputContainerBackground : Component

This property holds the delegate for the background of the full screen input container.

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputCursor : Component

This property holds the delegate for the cursor in the full screen input field.

The delegate should toggle the visibility of the cursor according to the parent.blinkStatus property defined for the full screen input field. For example:

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

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputFont : font

此特性保持 font for the full screen input field.

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputMargins : real

This property holds the margins around the full screen input field.

默认值为 0 .

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputPadding : real

This property holds the padding around the full screen input content.

默认值为 0 .

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputPasswordCharacter : string

This property holds the password mask character for the full screen input field.

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputSelectedTextColor : color

This property holds the selected text color for the full screen input field.

The default color is set to fullScreenInputColor .

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputSelectionColor : color

This property holds the selection color for the full screen input field.

The default color is semi-transparent black.

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.2.

handwritingKeyPanel : Component

Template for the handwriting mode key.

注意: The delegate must be based on the KeyPanel 类型。

hideKeyPanel : Component

Template for the hide key.

注意: The delegate must be based on the KeyPanel 类型。

keyPanel : Component

Template for the regular keys.

注意: The delegate must be based on the KeyPanel 类型。

范例:

keyPanel: KeyPanel {
    Rectangle {
        anchors.fill: parent
        ...
        Text {
            anchors.fill: parent
            text: control.displayText
            ...
        }
    }
}
																															

keyboardBackground : Component

Template for the keyboard background.

范例:

keyboardBackground: Rectangle {
    color: "black"
}
																																

keyboardDesignHeight : real

The design height of the keyboard.

keyboardDesignWidth : real

The design width of the keyboard.

keyboardHeight : real

The current height of the keyboard.

keyboardRelativeBottomMargin : real

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.

keyboardRelativeLeftMargin : real

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.

keyboardRelativeRightMargin : real

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.

keyboardRelativeTopMargin : real

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.

注意: The delegate must be based on the KeyPanel 类型。

languageListAdd : Transition

This property holds the transition to apply to items that are added to the language list view.

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.

languageListBackground : Component

Template for the language list background.

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.

languageListDelegate : Component

Template for the language list item.

注意: 委托用于 ListView .

注意: The delegate must be based on the SelectionListItem 类型。

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.

languageListHighlight : Component

Template for the language list highlight.

注意: The delegate is used as ListView.highlight .

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.

languageListRemove : Transition

This property holds the transition to apply to items that are removed from the language list view.

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.

languagePopupListEnabled : bool

This property determines whether a popup list will be shown when the language key is clicked. If this property is false , clicking the language key cycles through the available languages one at a time.

默认值为 false .

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.

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 特性。

注意: The delegate must be based on the KeyPanel 类型。

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.

注意: 委托用于 ListView .

注意: The delegate must be based on the SelectionListItem 类型。

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.

注意: 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.

[read-only] scaleHint : real

The keyboard style scale hint. This value is determined by dividing keyboardHeight by keyboardDesignHeight . 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.

注意: 委托用于 ListView .

注意: The delegate must be based on the SelectionListItem 类型。

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.

selectionListHeight : real

Selection list height.

selectionListHighlight : Component

Template for the selection list highlight.

注意: 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.

注意: The delegate must be based on the KeyPanel 类型。

spaceKeyPanel : Component

Template for the space key.

注意: The delegate must be based on the KeyPanel 类型。

symbolKeyPanel : Component

Template for the symbol mode key.

注意: The delegate must be based on the KeyPanel 类型。

traceCanvasDelegate : Component

Template for rendering a Trace object.

注意: The delegate must be based on the TraceCanvas 类型。

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.

traceInputKeyPanelDelegate : Component

Template for the trace input key.

注意: The delegate must be based on the TraceInputKeyPanel 类型。

This QML property was introduced in QtQuick.VirtualKeyboard.Styles 2.1.