Back to Qt.io
Contact Us Blog Download Qt
En esta página

KeyboardStyle QML Type

Proporciona una interfaz de estilo 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 InputPanel para decorar el teclado virtual.

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

Documentación de propiedades

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 ListView.

alternateKeysListHighlight : Component

Plantilla para el resaltado de 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

Anchura 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 previsualización de caracteres.

Si el delegado contiene la propiedad text, la propiedad se actualiza con el texto mostrado cuando el componente se activa.

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 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 de la entrada a pantalla completa.

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

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

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

El color por defecto es 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 para el cursor en el campo de entrada de pantalla completa.

El delegado debe alternar la visibilidad del cursor de acuerdo con 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 para el campo de entrada a pantalla completa.

Esta propiedad fue introducida en QtQuick.VirtualKeyboard.Styles 2.2.

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

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

El valor por defecto es 0.

Esta propiedad fue introducida en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad contiene el relleno alrededor del contenido de la entrada a pantalla completa.

El valor por defecto es 0.

Esta propiedad fue introducida en QtQuick.VirtualKeyboard.Styles 2.2.

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

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

Esta propiedad fue introducida en QtQuick.VirtualKeyboard.Styles 2.2.

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

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

El color por defecto es fullScreenInputColor.

Esta propiedad fue introducida en QtQuick.VirtualKeyboard.Styles 2.2.

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

Esta propiedad contiene el color de selección para el campo de entrada a pantalla completa.

El color por defecto es 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 funciones.

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 el resaltado de la lista emergente de funciones.

Nota: El delegado se utiliza como ListView.highlight.

Esta propiedad se introdujo en Qt 6.2.

handwritingKeyPanel : Component

Plantilla para la tecla de modo de escritura.

Nota: El delegado debe basarse en el tipo KeyPanel.

hideKeyPanel : Component

Plantilla para la clave de ocultación.

Nota: El delegado debe basarse en el tipo KeyPanel.

keyPanel : Component

Plantilla para las llaves 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.

keyboardDesignMaximumHeight : real [since 6.11]

La altura máxima de diseño del teclado.

Esta propiedad se introdujo en Qt 6.11.

keyboardDesignWidth : real

La anchura de diseño del teclado.

keyboardHeight : real

La altura actual del teclado.

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 más a la izquierda y el borde izquierdo del teclado, expresada en porcentaje (0.0 - 1.0) de la anchura del teclado.

keyboardRelativeRightMargin : real

La distancia entre las teclas más a la derecha y el borde derecho del teclado, expresada en porcentaje (0.0 - 1.0) de la anchura 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 en 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 contiene la transición a aplicar a los elementos que se añaden 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 ListView.

Nota: El delegado debe estar basado en el tipo SelectionListItem.

El elemento dispone de las siguientes propiedades:

  • displayName Nombre para mostrar del idioma.

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

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

Plantilla para el resaltado de 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 contiene la transición a aplicar a los elementos que se eliminan 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 pulsar la tecla de idioma. Si esta propiedad es false, al hacer clic en la tecla de idioma se recorren los idiomas disponibles de uno en uno.

El valor por defecto es false.

Esta propiedad fue introducida en QtQuick.VirtualKeyboard.Styles 2.1.

modeKeyPanel : Component

Plantilla para la tecla de modo genérico.

Esta plantilla proporciona una visualización de la tecla en la que el estado puede ser activado o desactivado. Esta plantilla se utiliza en situaciones en las que la etiqueta de la tecla seguirá siendo la misma independientemente del estado.

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

Nota: El delegado debe estar basado en el tipo KeyPanel.

Plantilla para el elemento de resaltado de navegación.

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

El elemento es típicamente 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 contiene la transición a aplicar a los elementos que se añaden 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 lista emergente.

Nota: El delegado se utiliza en ListView.

Nota: El delegado debe estar basado en el tipo SelectionListItem.

El elemento dispone de las siguientes propiedades:

  • display Texto de visualización para el elemento actual.
  • wordCompletionLength Longitud de finalización de la palabra medida desde el final del texto visualizado.
  • dictionary Tipo de diccionario de la palabra, véase QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Un booleano que indica si la palabra puede ser eliminada del diccionario.

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

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

Plantilla para el resaltado de 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 contiene la transición a aplicar a los elementos que se eliminan de la vista de lista emergente.

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

scaleHint : real [read-only]

La sugerencia de escala de estilo de teclado. Este valor se determina dividiendo keyboardHeight por keyboardDesignHeight. Todas las dimensiones de los píxeles deben ser proporcionales a este valor.

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

Este elemento se utiliza para indicar dónde están los límites de la selección de texto y poder mover interactivamente el inicio o el final de la selección. El mismo elemento se utiliza tanto para la selección inicial como para la final.

Actualmente, los manejadores de selección sólo 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 contiene la transición a aplicar a los elementos que se añaden 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 ListView.

Nota: El delegado debe basarse en el tipo SelectionListItem.

El elemento dispone de las siguientes propiedades:

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

selectionListHeight : real

Altura de la lista de selección.

selectionListHighlight : Component

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

Nota: El delegado se utiliza como ListView.highlight.

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

Esta propiedad contiene la transición a aplicar a los elementos que se eliminan de la vista de lista de selección.

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

shiftKeyPanel : Component

Plantilla para la tecla de mayúsculas.

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 tecla de modo de símbolo.

Nota: El delegado debe basarse en el tipo KeyPanel.

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

Plantilla para renderizar un objeto Trace.

Nota: El delegado debe estar basado 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 estar basado 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.