En esta página

BaseKey QML Type

Clase padre común para todos los tipos de clave. Más...

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

Item

Inherited By:
14 types

BackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, FlickKey, HandwritingModeKey, HideKeyboardKey, InputModeKey, Key, ModeKey, NumberKey, ShiftKey, SpaceKey, and SymbolModeKey

Propiedades

Señales

Descripción detallada

BaseKey es un tipo común para todas las teclas de la distribución del teclado.

Este tipo no debe utilizarse directamente en las distribuciones. En su lugar, deben utilizarse los tipos de teclas especializados, como «Key» o « EnterKey ».

Documentación de propiedades

active : bool

Esta propiedad indica el estado de activación de la tecla.

Esta propiedad se establece automáticamente en «true» cuando se pulsa la tecla.

alternativeKeys : var

Establece la lista de claves alternativas.

Esta propiedad puede establecerse como una cadena o una lista de cadenas. Si el valor es una cadena, las teclas alternativas se presentan como caracteres individuales de dicha cadena. Si el valor es una lista de cadenas, se utiliza la lista en su lugar.

Las teclas alternativas se muestran al usuario al mantener pulsada una tecla que tenga establecida esta propiedad.

Nota: Si las teclas alternativas contienen la tecla « text », esta se filtrará de la lista « effectiveAlternativeKeys » y, en su lugar, se utilizará su posición como indicador del elemento resaltado.

El valor por defecto es una lista vacía.

displayAlternativeKeys : var [since 6.2]

Esta propiedad permite sobrescribir la lista de cadenas de teclas que se muestra al usuario en la vista de teclas alternativas.

Esta propiedad se introdujo en Qt 6.2.

displayText : string

Establece el texto que se muestra.

Esta cadena se muestra en la distribución del teclado.

El valor por defecto es el texto de la tecla.

effectiveAlternativeKeys : var [read-only, since QtQuick.VirtualKeyboard 2.0]

Esta propiedad contiene las claves alternativas efectivas que se muestran al usuario.

La lista contiene los elementos de « alternativeKeys », excluyendo el elemento « text ».

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.0.

effectiveAlternativeKeysHighlightIndex : int [read-only, since QtQuick.VirtualKeyboard 2.0]

Esta propiedad contiene el índice del elemento resaltado en effectiveAlternativeKeys.

El índice se calcula a partir del índice de la clave « text » en la tabla « alternativeKeys ».

Por ejemplo, si las teclas alternativas contienen «çcċčć» y la clave text es «c», este índice será 1 y las teclas alternativas efectivas que se mostrarán al usuario serán «ç[ċ]čć».

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.0.

functionKey : bool

Establece el atributo de la tecla de función.

El valor predeterminado es «false».

highlighted : bool

Establece el estado de «destacado» de la tecla.

El valor por defecto es «false».

key : int

Establece el código de tecla para el procesamiento del método de entrada.

El valor por defecto es Qt.Key_unknown.

keyPanelDelegate : alias

Establece el delegado del panel de teclas para la tecla.

Esta propiedad es esencial para la decoración de la tecla. Sin un delegado del panel de teclas, la tecla es invisible. Esta propiedad debe asignarse en el tipo de tecla heredado.

keyType : int [since 6.1]

Key Tipo de la tecla especializada. Los valores posibles se definen en {QtVirtualKeyboard::KeyType}{enumeración de tipos de teclas}.

Por ejemplo, SpaceKey establece este valor en QtVirtualKeyboard.KeyType.SpaceKey.

Esta propiedad se introdujo en Qt 6.1.

noKeyEvent : bool [since QtQuick.VirtualKeyboard 1.3]

Esta propiedad controla si la tecla emite eventos de tecla para el procesamiento del método de entrada. Cuando el valor es «true», los eventos de tecla quedan desactivados.

Por defecto, se emite el evento de tecla si la tecla no es desconocida o si el texto no está vacío.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 1.3.

noModifier : bool [since QtQuick.VirtualKeyboard 1.3]

Desactiva los modificadores de teclas en la tecla emitida.

El valor por defecto es «false».

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 1.3.

pressed : bool

Esta propiedad almacena el estado de pulsación de la tecla.

El estado de pulsación solo puede ser «true» si la tecla está habilitada y activa. Cuando el estado de la tecla pasa a «pulsada», se activa un evento de pulsación de tecla para el motor de entrada. Se activa un evento de liberación de tecla cuando se suelta la tecla.

repeat : bool

Establece el atributo de repetición de teclas.

Si se habilita la repetición, la tecla repetirá los eventos de entrada mientras se mantenga pulsada. No se debe utilizar la repetición si también se ha establecido « alternativeKeys ».

El valor por defecto es «false».

showPreview : bool

Establece el atributo «mostrar vista previa».

Por defecto, la ventana emergente de vista previa de caracteres no se muestra para las teclas de función, ni cuando el elemento de entrada activo oculta el texto que muestra, por ejemplo, un campo de contraseña. En este último caso, la vista previa revelaría los caracteres que el elemento de entrada oculta.

smallText : string [since QtQuick.VirtualKeyboard 2.0]

Establece el texto pequeño que se muestra en la esquina de la tecla.

El valor por defecto se basa en el elemento predeterminado de las teclas alternativas efectivas.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.0.

smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]

Establece la visibilidad del texto pequeño.

El valor por defecto se hereda del elemento padre.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.0.

soundEffect : url [read-only, since QtQuick.VirtualKeyboard 1.1]

Esta propiedad contiene el efecto de sonido que se reproducirá al pulsar una tecla.

Esta propiedad es de solo lectura, ya que los efectos de sonido se definen en el estilo del teclado.

Esta propiedad se introdujo en QtQuick.VirtualKeyboard 1.1.

text : string

Establece el texto de la tecla para el procesamiento del método de entrada.

En la mayoría de los casos, se trata de la representación Unicode del código de la tecla.

El valor por defecto es una cadena vacía.

uppercased : bool

Esta propiedad indica si la tecla está en mayúsculas.

Por defecto, esta propiedad refleja el estado de mayúsculas del teclado.

weight : real

Establece el valor del peso de la tecla, que determina el tamaño relativo de la misma.

Utiliza esta propiedad para cambiar el tamaño de la clave en el diseño.

El valor por defecto se hereda del elemento padre de la tecla en la jerarquía del diseño.

Documentación de Signal

clicked()

Esta señal se activa al pulsar la tecla, lo que permite un procesamiento personalizado de la misma.

Nota: El controlador correspondiente es onClicked.

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