BaseKey QML Type
Padre común para todos los tipos de clave. Más...
| Import Statement: | import QtQuick.VirtualKeyboard.Components |
| Inherits: | |
| Inherited By: | 14 typesBackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, FlickKey, HandwritingModeKey, HideKeyboardKey, InputModeKey, Key, ModeKey, NumberKey, ShiftKey, SpaceKey, and SymbolModeKey |
Propiedades
- active : bool
- alternativeKeys : var
- displayAlternativeKeys : var
(since 6.2) - displayText : string
- effectiveAlternativeKeys : var
(since QtQuick.VirtualKeyboard 2.0) - effectiveAlternativeKeysHighlightIndex : int
(since QtQuick.VirtualKeyboard 2.0) - functionKey : bool
- highlighted : bool
- key : int
- keyPanelDelegate : alias
- keyType : int
(since 6.1) - noKeyEvent : bool
(since QtQuick.VirtualKeyboard 1.3) - noModifier : bool
(since QtQuick.VirtualKeyboard 1.3) - pressed : bool
- repeat : bool
- showPreview : bool
- smallText : string
(since QtQuick.VirtualKeyboard 2.0) - smallTextVisible : bool
(since QtQuick.VirtualKeyboard 2.0) - soundEffect : url
(since QtQuick.VirtualKeyboard 1.1) - text : string
- uppercased : bool
- weight : real
Señales
- clicked()
Descripción detallada
BaseKey es un tipo común para todas las teclas en la disposición del teclado.
Este tipo no debe utilizarse directamente en las distribuciones. En su lugar deben utilizarse los tipos de tecla especializados, como Key o EnterKey.
Documentación de propiedades
active : bool
Esta propiedad contiene el estado activo 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 ser una cadena o una lista de cadenas. Si el valor es una cadena, las claves alternativas se presentan como caracteres individuales de esa cadena. Si el valor es una lista de cadenas, se utiliza la lista en su lugar.
Las teclas alternativas se presentan al usuario pulsando y manteniendo pulsada una tecla con esta propiedad.
Nota: Si las teclas alternativas contienen la tecla text, se filtrará de effectiveAlternativeKeys y en su lugar se utilizará su posición como indicador del elemento resaltado.
Por defecto, la lista está vacía.
displayAlternativeKeys : var [since 6.2]
Esta propiedad permite sobreescribir la lista de cadenas de teclas presentadas al usuario en la vista de teclas alternativas.
Esta propiedad se introdujo en Qt 6.2.
displayText : string
Establece el texto a mostrar.
Esta cadena se muestra en la disposició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 presentadas al usuario.
La lista contiene los elementos en alternativeKeys excluyendo el elemento text.
Esta propiedad fue introducida 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 alternativeKeys.
Por ejemplo, si las teclas alternativas contienen "çcċčć" y la tecla text es "c", este índice se convertirá en 1 y las teclas alternativas efectivas presentadas al usuario serán "ç[ċ]čć".
Esta propiedad fue introducida en QtQuick.VirtualKeyboard 2.0.
functionKey : bool
Establece el atributo de tecla de función.
El valor predeterminado es false.
highlighted : bool
Establece el estado de resaltado de la tecla.
El valor predeterminado es false.
key : int
Establece el código clave para el procesamiento del método de entrada.
El valor predeterminado es Qt.Key_unknown.
keyPanelDelegate : alias
Establece el delegado del panel de la llave.
Esta propiedad es esencial para la decoración de la llave. Sin un delegado de panel de claves, la clave es invisible. Esta propiedad debe asignarse en el tipo de clave heredada.
keyType : int [since 6.1]
Key para la clave especializada. Los valores posibles están definidos por la enumeración {QtVirtualKeyboard::KeyType}{key type enumeration}.
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 es true, los eventos clave están desactivados.
Por defecto, el evento de tecla se emite si la tecla no es desconocida o el texto no está vacío.
Esta propiedad fue introducida en QtQuick.VirtualKeyboard 1.3.
noModifier : bool [since QtQuick.VirtualKeyboard 1.3]
Desactiva los modificadores de tecla en la tecla emitida.
Por defecto es false.
Esta propiedad se introdujo en QtQuick.VirtualKeyboard 1.3.
pressed : bool
Esta propiedad contiene el estado de pulsación de la tecla.
El estado pulsado sólo puede ser verdadero si la tecla está habilitada y activa. Cuando el estado de la tecla se vuelve pulsado, se desencadena un evento de tecla pulsada para el motor de entrada. Cuando se suelta la tecla, se desencadena un evento de pulsación.
repeat : bool
Establece el atributo de repetición de la tecla.
Si la repetición está activada, la tecla repetirá los eventos de entrada mientras se mantenga pulsada. La repetición no debe utilizarse si alternativeKeys también está activado.
Por defecto es false.
showPreview : bool
Establece el atributo mostrar vista previa.
Por defecto, la ventana emergente de previsualización de caracteres no se muestra para las teclas de función.
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 por defecto en las teclas alternativas efectivas.
Esta propiedad fue introducida 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 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 sólo lectura ya que los efectos de sonido se definen en el estilo de teclado.
Esta propiedad se introdujo en QtQuick.VirtualKeyboard 1.1.
text : string
Establece el texto clave 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 clave.
El valor por defecto es una cadena vacía.
uppercased : bool
Esta propiedad contiene el estado de mayúsculas de la tecla.
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 tecla.
Utilice 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 clave en la jerarquía del diseño.
Documentación de la señal
clicked()
Esta señal se activa cuando se pulsa la tecla, lo que permite un procesamiento personalizado de la tecla.
Nota: El manejador 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.
