En esta página

KeyboardStyle QML Type

Ofrece una interfaz de personalización para el teclado virtual. Más...

Import Statement: import QtQuick.VirtualKeyboard.Styles
Inherits:

QtObject

Propiedades

Descripción detallada

El tipo de estilo proporciona las definiciones de estilo que utiliza el InputPanel para decorar el teclado virtual.

El tamaño de diseño especifica la relación de aspecto del teclado virtual. Los estilos son escalables según la relación de aspecto ( scaleHint), que se calcula a partir de la altura real del teclado y la altura de diseño.

El teclado se diseña con un tamaño de diseño fijo, definido por ` keyboardDesignWidth ` y ` keyboardDesignHeight`, y luego se escala para adaptarse al ancho disponible. La altura renderizada se deriva de la relación de aspecto del diseño: ` keyboardDesignHeight * width / keyboardDesignWidth`. ` keyboardHeight ` refleja la altura real y escalada que se utiliza en tiempo de ejecución.

keyboardDesignMaximumHeight Opcionalmente, se puede limitar esa altura. Mientras el límite no esté activo, el área de teclas ocupa todo el ancho disponible. Cuando la altura escalada superaría el máximo, se conserva la relación de aspecto del diseño y, en su lugar, se escala todo el teclado según keyboardDesignMaximumHeight / keyboardDesignHeight, de modo que el teclado nunca supera la altura máxima. En ese caso de limitación, el área de las teclas se vuelve más estrecha que el ancho disponible y se centra, dejando márgenes vacíos a ambos lados; solo el fondo del teclado sigue ocupando todo el ancho. scaleHint es la relación entre keyboardHeight y keyboardDesignHeight y debe utilizarse para mantener proporcionales todas las dimensiones en píxeles.

Ten en cuenta que keyboardDesignWidth y keyboardDesignHeight son unidades de diseño (los estilos integrados utilizan 2560x800 y nunca se representan a ese tamaño), mientras que keyboardDesignMaximumHeight se expresa en píxeles lógicos, ya que se compara directamente con la altura representada (que también está en píxeles lógicos).

Documentación de la propiedad

alternateKeysListBackground : Component

Plantilla para el fondo de la lista de teclas alternativas.

alternateKeysListBottomMargin : real

Margen inferior del panel de la lista de teclas alternativas.

alternateKeysListDelegate : Component

Plantilla para el elemento de la lista de claves alternativas.

Nota: El delegado se utiliza en un ListView.

El elemento dispone de las siguientes propiedades:

  • text: el texto de la clave
  • data: Los datos de la clave

alternateKeysListHighlight : Component

Plantilla para resaltar la lista de teclas alternativas.

Nota: El delegado se utiliza como ListView.highlight.

alternateKeysListItemHeight : real

Altura del elemento de la lista de teclas alternativas.

alternateKeysListItemWidth : real

Ancho del elemento de la lista de teclas alternativas.

alternateKeysListLeftMargin : real

Margen izquierdo del panel de la lista de teclas alternativas.

alternateKeysListRightMargin : real

Margen derecho del panel de la lista de teclas alternativas.

alternateKeysListTopMargin : real

Margen superior del panel de la lista de teclas alternativas.

backspaceKeyPanel : Component

Plantilla para la tecla de retroceso.

Nota: El delegado debe basarse en el tipo « KeyPanel ».

characterPreviewDelegate : Component

Plantilla para la ventana emergente de vista previa de caracteres.

Si el delegado contiene la propiedad « text », esta se actualiza con el texto que se mostrará cuando el componente se active.

property string text

Ejemplo:

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

characterPreviewMargin : real

Número de píxeles entre la parte superior de cada tecla y la parte inferior de la characterPreviewDelegate.

enterKeyPanel : Component

Plantilla para la tecla Intro.

Nota: El delegado debe basarse en el tipo « KeyPanel ».

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

Esta propiedad contiene el delegado para el fondo del campo de entrada a pantalla completa.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad define el color del texto del campo de entrada a pantalla completa.

El color predeterminado es el negro.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad contiene el delegado para el fondo del contenedor de entrada a pantalla completa.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad contiene el delegado del cursor en el campo de entrada a pantalla completa.

El delegado debe alternar la visibilidad del cursor según la propiedad « parent.blinkStatus » definida para el campo de entrada a pantalla completa. Por ejemplo:

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

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad contiene el « font » (estilo de teclado virtual) para el campo de entrada a pantalla completa.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad define los márgenes alrededor del campo de entrada a pantalla completa.

El valor por defecto es 0.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad define el margen alrededor del contenido de la entrada a pantalla completa.

El valor por defecto es « 0 ».

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad contiene el carácter de enmascaramiento de contraseña para el campo de entrada a pantalla completa.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad establece el color del texto seleccionado para el campo de entrada a pantalla completa.

El color predeterminado es fullScreenInputColor.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad establece el color de selección del campo de entrada a pantalla completa.

El color predeterminado es el negro semitransparente.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.2.

functionPopupListBackground : Component [since 6.2]

Plantilla para el fondo de la lista emergente de la función.

Esta propiedad se introdujo en Qt 6.2.

functionPopupListDelegate : Component [since 6.2]

Plantilla para el elemento de la lista de funciones.

Nota: El delegado se utiliza en un ` ListView`.

El elemento dispone de las siguientes propiedades:

  • keyboardFunction - Función de teclado del elemento actual.

Esta propiedad se introdujo en Qt 6.2.

functionPopupListHighlight : Component [since 6.2]

Plantilla para resaltar la lista emergente de la función.

Nota: El delegado se utiliza como « ListView.highlight ».

Esta propiedad se introdujo en Qt 6.2.

handwritingKeyPanel : Component

Plantilla para la tecla del modo de escritura a mano.

Nota: El delegado debe basarse en el tipo « KeyPanel ».

hideKeyPanel : Component

Plantilla para la clave «hide».

Nota: El delegado debe basarse en el tipo KeyPanel.

keyPanel : Component

Plantilla para las claves normales.

Nota: El delegado debe basarse en el tipo « KeyPanel ».

Ejemplo:

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

keyboardBackground : Component

Plantilla para el fondo del teclado.

Ejemplo:

keyboardBackground: Rectangle {
    color: "black"
}

keyboardDesignHeight : real

La altura de diseño del teclado, en unidades de autoría.

Junto con « keyboardDesignWidth », define la relación de aspecto de diseño de la distribución del teclado. La altura representada es « keyboardDesignHeight * width / keyboardDesignWidth », a menos que dicho valor supere « keyboardDesignMaximumHeight », en cuyo caso se conserva la relación de aspecto de diseño y, en su lugar, se escala todo el teclado mediante « keyboardDesignMaximumHeight / keyboardDesignHeight ». También es la altura de referencia utilizada por « scaleHint ».

keyboardDesignMaximumHeight : real [since 6.11]

La altura máxima de diseño del teclado, en píxeles lógicos.

Cuando se establece en un valor superior a 0, limita la altura renderizada que, de otro modo, resultaría al escalar keyboardDesignHeight al ancho disponible. Si la altura escalada supera este máximo, el teclado se renderiza a keyboardDesignMaximumHeight; se conserva la relación de aspecto de diseño y, en su lugar, todo el teclado se escala por keyboardDesignMaximumHeight / keyboardDesignHeight, de modo que el teclado nunca supera la altura máxima. Un valor de 0 o inferior (el valor por defecto) significa que no hay un máximo, por lo que la altura sigue a keyboardDesignHeight escalada a la anchura.

A diferencia de keyboardDesignWidth y keyboardDesignHeight, este valor se expresa en píxeles lógicos, ya que se compara directamente con la altura renderizada.

Esta propiedad se introdujo en Qt 6.11.

keyboardDesignWidth : real

El ancho de diseño del teclado, en unidades de diseño.

Junto con keyboardDesignHeight, define la relación de aspecto de diseño de la distribución del teclado. El estilo se crea con este tamaño y, a continuación, se escala al ancho real; la altura representada se deriva de keyboardDesignHeight * width / keyboardDesignWidth.

keyboardHeight : real

La altura actual del teclado, en píxeles lógicos.

Se trata de la altura real y escalada a la que se representa el teclado. La establece la implementación del teclado (vinculada a la altura del contenedor del área de teclas) y refleja la disposición resultante de aplicar keyboardDesignWidth, keyboardDesignHeight y, si está establecido, keyboardDesignMaximumHeight al ancho disponible. Úsalo junto con keyboardDesignHeight para obtener scaleHint.

keyboardRelativeBottomMargin : real

La distancia entre las teclas más bajas y el borde inferior del contenedor del teclado, expresada como porcentaje (0.0 - 1.0) de la altura del teclado.

keyboardRelativeLeftMargin : real

La distancia entre las teclas situadas más a la izquierda y el borde izquierdo del teclado, expresada como porcentaje (0.0 - 1.0) del ancho del teclado.

keyboardRelativeRightMargin : real

La distancia entre las teclas situadas más a la derecha y el borde derecho del teclado, expresada como porcentaje (0.0 - 1.0) del ancho del teclado.

Este valor es proporcional a la anchura del teclado.

keyboardRelativeTopMargin : real

La distancia entre las teclas más altas y el borde superior del teclado, expresada como porcentaje (0.0 - 1.0) de la altura del teclado.

languageKeyPanel : Component

Plantilla para la clave de idioma.

Nota: El delegado debe basarse en el tipo « KeyPanel ».

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

Esta propiedad determina la transición que se aplicará a los elementos que se añadan a la vista de lista de idiomas.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Plantilla para el fondo de la lista de idiomas.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Plantilla para el elemento de la lista de idiomas.

Nota: El delegado se utiliza en un ListView.

Nota: El delegado debe basarse en el tipo SelectionListItem.

El elemento dispone de las siguientes propiedades:

  • displayName Nombre que se muestra del idioma.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Plantilla para resaltar la lista de idiomas.

Nota: El delegado se utiliza como ListView.highlight.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Esta propiedad define la transición que se aplicará a los elementos que se eliminen de la vista de lista de idiomas.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

languagePopupListEnabled : bool [since QtQuick.VirtualKeyboard.Styles 2.1]

Esta propiedad determina si se mostrará una lista emergente al hacer clic en la tecla de idioma. Si esta propiedad tiene el valor « false », al hacer clic en la tecla de idioma se irá alternando entre los idiomas disponibles, uno por uno.

El valor por defecto es « false ».

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

modeKeyPanel : Component

Plantilla para la tecla de modo genérico.

Esta plantilla ofrece una visualización de la tecla, cuyo estado puede ser «activado» o «desactivado». Se utiliza en situaciones en las que la etiqueta de la tecla permanece igual independientemente de su estado.

El estado actual está disponible en la propiedad control.mode.

Nota: El delegado debe basarse en el tipo « KeyPanel ».

Plantilla para el elemento destacado de navegación.

Este elemento se utiliza en el modo de navegación con las teclas de flecha para resaltar el foco de navegación en el teclado.

Normalmente, el elemento es un rectángulo transparente con un borde de alto contraste.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 1.1.

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

Esta propiedad determina la transición que se aplicará a los elementos que se añadan a la vista de lista emergente.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Plantilla para el fondo de la lista emergente.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Plantilla para el elemento de la lista emergente.

Nota: El delegado se utiliza en un ListView.

Nota: El delegado debe basarse en el tipo « SelectionListItem ».

El elemento dispone de las siguientes propiedades:

  • display Texto que se muestra para el elemento actual.
  • wordCompletionLength Longitud de autocompletado de palabras medida desde el final del texto que se muestra.
  • dictionary Tipo de diccionario de la palabra; véase QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Un valor booleano que indica si la palabra puede eliminarse del diccionario.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Plantilla para resaltar la lista emergente.

Nota: El delegado se utiliza como ` ListView.highlight`.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Esta propiedad determina la transición que se aplicará a los elementos que se eliminen de la vista de lista emergente.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

scaleHint : real [read-only]

La indicación de escala de estilo de teclado. Este valor se calcula dividiendo keyboardHeight entre keyboardDesignHeight. Todas las dimensiones en píxeles deben ser proporcionales a este valor.

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

Este elemento sirve para indicar dónde se encuentran los límites de la selección de texto y para poder desplazar de forma interactiva el inicio o el final de la selección. Se utiliza el mismo elemento tanto para el inicio como para el final de la selección.

Actualmente, los controladores de selección solo son compatibles con el método de integración basado en la aplicación.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Esta propiedad determina la transición que se aplicará a los elementos que se añadan a la vista de lista de selección.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 1.3.

selectionListBackground : Component

Plantilla para el fondo de la lista de selección.

selectionListDelegate : Component

Plantilla para el elemento de la lista de selección.

Nota: El delegado se utiliza en un ` ListView`.

Nota: El delegado debe basarse en el tipo SelectionListItem.

El elemento dispone de las siguientes propiedades:

  • display Texto que se muestra para el elemento actual.
  • wordCompletionLength Longitud de autocompletado de palabras medida desde el final del texto de visualización.
  • dictionary Tipo de diccionario de la palabra; véase QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Un valor booleano que indica si la palabra puede eliminarse del diccionario.

selectionListHeight : real

Altura de la lista de selección.

selectionListHighlight : Component

Plantilla para resaltar la lista de selección.

Nota: El delegado se utiliza como ListView.highlight.

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

Esta propiedad determina la transición que se aplicará a los elementos que se eliminen de la vista de lista de selección.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 1.3.

shiftKeyPanel : Component

Plantilla para la clave de turno.

Nota: El delegado debe basarse en el tipo KeyPanel.

spaceKeyPanel : Component

Plantilla para la tecla de espacio.

Nota: El delegado debe basarse en el tipo KeyPanel.

symbolKeyPanel : Component

Plantilla para la clave del modo de símbolo.

Nota: El delegado debe basarse en el tipo « KeyPanel ».

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

Plantilla para representar un objeto Trace.

Nota: El delegado debe basarse en el tipo ` TraceCanvas `.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

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

Plantilla para la clave de entrada de rastreo.

Nota: El delegado debe basarse en el tipo « TraceInputKeyPanel ».

Esta propiedad se introdujo en QtQuick.VirtualKeyboard.Styles 2.1.

© 2026 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.