InputPanel QML Type
Proporciona la interfaz de usuario del teclado virtual. Más...
| Import Statement: | import QtQuick.VirtualKeyboard |
| Inherits: |
Propiedades
- active : bool
(since QtQuick.VirtualKeyboard 2.0) - externalLanguageSwitchEnabled : bool
(since QtQuick.VirtualKeyboard 2.4)
Señales
- externalLanguageSwitch(var localeList, int currentIndex)
(since QtQuick.VirtualKeyboard 2.4)
Descripción detallada
El tamaño del teclado se calcula automáticamente a partir del ancho disponible; es decir, el teclado mantiene la relación de aspecto especificada por el estilo actual. Por lo tanto, la aplicación solo debe establecer las coordenadas width y y del InputPanel, y no la height.
Al igual que con el resto de tipos QML proporcionados por el módulo, la variable de entorno QT_IM_MODULE debe establecerse en qtvirtualkeyboard antes de utilizar InputPanel. Para obtener más información, consulta Carga del complemento.
Nota: Solopuede haber una instancia de InputPanel en su aplicación. El panel no quedará bloqueado por cuadros de diálogo modales, pero puede quedar oculto por elementos con un valor de z más alto.
Documentación de propiedades
active : bool [since QtQuick.VirtualKeyboard 2.0]
Esta propiedad refleja el estado activo del panel de entrada. El teclado debe mostrarse al usuario cuando esta propiedad esté en el valor « true ».
Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.0.
externalLanguageSwitchEnabled : bool [since QtQuick.VirtualKeyboard 2.4]
Esta propiedad habilita el mecanismo externo de cambio de idioma. Cuando esta propiedad tiene el valor « true », el teclado virtual no mostrará el menú emergente de idiomas integrado, sino que emitirá la señal « externalLanguageSwitch ». La aplicación puede gestionar esta señal y mostrar, en su lugar, un cuadro de diálogo personalizado para la selección de idioma.
Esta propiedad se introdujo en QtQuick.VirtualKeyboard 2.4.
Documentación de señales
[since QtQuick.VirtualKeyboard 2.4] externalLanguageSwitch(var localeList, int currentIndex)
Esta señal se emite cuando externalLanguageSwitchEnabled es true y el usuario pulsa la tecla de cambio de idioma.
Sirve como gancho para mostrar un cuadro de diálogo de idioma personalizado en lugar de la ventana emergente de idioma integrada en el teclado virtual.
El parámetro localeList contiene una lista de nombres de configuraciones regionales entre las que elegir. Para obtener más información sobre un idioma concreto, utiliza la función Qt.locale(). El currentIndex es el índice de la configuración regional actual en el localeList. Este elemento debe aparecer resaltado como el elemento actual en la interfaz de usuario.
Para seleccionar un nuevo idioma, utilice la propiedad VirtualKeyboardSettings.locale.
A continuación se muestra un ejemplo que ilustra la implementación de un cuadro de diálogo de idioma personalizado:
Dialog {
id: languageDialog
title: "Select Input Language"
modality: Qt.ApplicationModal
function show(localeList, currentIndex) {
languageListModel.clear()
for (var i = 0; i < localeList.length; i++) {
languageListModel.append({localeName: localeList[i], displayName: Qt.locale(localeList[i]).nativeLanguageName})
}
languageListView.currentIndex = currentIndex
languageListView.positionViewAtIndex(currentIndex, ListView.Center)
languageDialog.visible = true
}
contentItem: ListView {
id: languageListView
model: ListModel {
id: languageListModel
function selectItem(index) {
VirtualKeyboardSettings.locale = languageListModel.get(index).localeName
languageDialog.visible = false
}
}
delegate: Item {
id: languageListItem
width: languageNameTextMetrics.width * 17
height: languageNameTextMetrics.height + languageListLabel.anchors.topMargin + languageListLabel.anchors.bottomMargin
Text {
id: languageListLabel
anchors.left: parent.left
anchors.top: parent.top
anchors.leftMargin: languageNameTextMetrics.height / 2
anchors.rightMargin: anchors.leftMargin
anchors.topMargin: languageNameTextMetrics.height / 3
anchors.bottomMargin: anchors.topMargin
text: languageNameFormatter.elidedText
color: "#5CAA15"
font {
weight: Font.Normal
pixelSize: 28
}
}
TextMetrics {
id: languageNameTextMetrics
font {
weight: Font.Normal
pixelSize: 28
}
text: "X"
}
TextMetrics {
id: languageNameFormatter
font {
weight: Font.Normal
pixelSize: 28
}
elide: Text.ElideRight
elideWidth: languageListItem.width - languageListLabel.anchors.leftMargin - languageListLabel.anchors.rightMargin
text: displayName
}
MouseArea {
anchors.fill: parent
hoverEnabled: true
onClicked: {
if (index === -1)
return
parent.ListView.view.currentIndex = index
parent.ListView.view.model.selectItem(index)
}
}
states: State {
name: "current"
when: languageListItem.ListView.isCurrentItem
PropertyChanges {
target: languageListLabel
color: "black"
}
}
}
}
}El cuadro de diálogo se declararía así:
LanguageDialog {
id: languageDialog
width: 400
height: 400
}En el archivo ` InputPanel` de la aplicación, añade el siguiente código:
InputPanel {
id: inputPanel
externalLanguageSwitchEnabled: true
onExternalLanguageSwitch: languageDialog.show(localeList, currentIndex)
// ...
}El cuadro de diálogo personalizado se mostrará ahora al pulsar la tecla de cambio de idioma.
Nota: El controlador correspondiente es ` onExternalLanguageSwitch`.
Esta señal se introdujo en QtQuick.VirtualKeyboard 2.4.
© 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.