Calqlatr
Una calculadora diseñada para dispositivos en orientación horizontal y vertical. Utiliza componentes personalizados de Qt Quick y diseños adaptativos para la interfaz de usuario, así como JavaScript para la lógica de la aplicación.

Calqlatr muestra diversas características de QML y Qt Quick , como la visualización de componentes personalizados y el uso de diseños adaptativos. La lógica de la aplicación está implementada en JavaScript y la interfaz de usuario, en QML.
Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Tras ejecutar el ejemplo, deberías poder utilizar la aplicación como una calculadora estándar. Cambia el teléfono del modo vertical al horizontal —o, en el escritorio, cambia el tamaño de la ventana principal— para activar el diseño adaptativo.
Uso de componentes personalizados
La aplicación Calqlatr utiliza tipos personalizados. La mayoría de ellos se definen en su propio archivo .qml independiente:
Main.qmlcontent/ApplicationState.qmlcontent/BackspaceButton.qmlcontent/CalculatorButton.qmlcontent/Display.qmlcontent/NumberPad.qml
Main.qml contiene la ventana de nivel superior y el elemento raíz. Utiliza los demás tipos personalizados del directorio « content ». Por ejemplo, el tipo « NumberPad » (definido en content/NumberPad.qml) se utiliza en Main.qml para crear el teclado numérico de la calculadora:
NumberPad {
id: numberPad
Layout.margins: root.margin
isPortraitMode: root.isPortraitMode
applicationState: appState
}Los componentes en línea permiten declarar varios componentes dentro de un archivo ` .qml `. El ejemplo utiliza componentes en línea en ` NumberPad.qml ` para definir dos componentes, ` DigitButton ` y ` OperatorButton`:
component DigitButton: CalculatorButton {
onClicked: {
controller.applicationState.digitPressed(text);
controller.updateDimmed();
}
}
component OperatorButton: CalculatorButton {
dimmable: true
implicitWidth: 48
textColor: controller.qtGreenColor
onClicked: {
controller.applicationState.operatorPressed(text);
controller.updateDimmed();
}
}Ambos componentes son de tipo CalculatorButton (tal y como se define en CalculatorButton.qml), pero proporcionan un controlador personalizado para la señal «clicked» y ajustan algunos valores predeterminados de las propiedades. Posteriormente, DigitButton y OperatorButton se instancian en NumberPad.qml:
DigitButton {
text: "e"
dimmable: true
implicitWidth: 48
}
OperatorButton { text: "ln" }Consulta «Definición de tipos de objetos mediante documentos QML » para obtener más detalles sobre cómo definir componentes QML personalizados.
Diseños adaptativos
En este ejemplo, los diseños adaptativos organizan los diferentes componentes de la interfaz de usuario tanto para el modo vertical como para el horizontal. Esto se puede observar en Main.qml, que define un ColumnLayout para el modo vertical y un RowLayout para el modo horizontal:
ColumnLayout {
id: portraitMode
anchors.fill: parent
visible: root.isPortraitMode
LayoutItemProxy {
target: calcDisplay
Layout.minimumHeight: calcDisplay.minHeight
}
LayoutItemProxy {
target: numberPad
Layout.alignment: Qt.AlignHCenter
}
}
RowLayout {
id: landscapeMode
anchors.fill: parent
visible: !root.isPortraitMode
LayoutItemProxy {
target: calcDisplay
}
LayoutItemProxy {
target: numberPad
Layout.alignment: Qt.AlignVCenter
}
}El archivo ColumnLayout representa el diseño vertical de la aplicación, y el RowLayout representa el diseño horizontal. Las propiedades de visible determinan qué diseño se utiliza en cada momento. El atributo «id» de los componentes NumberPad y Display se utiliza para establecer la propiedad « target » de los tipos LayoutItemProxy. Esto permite que ambos diseños utilicen los mismos elementos de contenido. Además, las propiedades se pueden reenviar desde el elemento LayoutItemProxy al propio target. Por ejemplo, cuando se instancia el NumberPad, ambos diseños requieren un Layout.alignment diferente.
También se utiliza un diseño adaptativo en NumberPad.qml al definir los diseños vertical y horizontal para el propio NumberPad:
RowLayout {
spacing: controller.spacing
GridLayout {
id: scientificGrid
columns: 3
columnSpacing: controller.spacing
rowSpacing: controller.spacing
visible: !controller.isPortraitMode
OperatorButton {
text: "x²"
Accessible.name: "x squared"
}
OperatorButton {
text: "⅟x"
Accessible.name: "one over x"
}
OperatorButton { text: "√" }
OperatorButton {
text: "x³"
Accessible.name: "x cubed"
}
OperatorButton {
text: "sin"
Accessible.name: "sine"
}
OperatorButton {
text: "|x|"
Accessible.name: "absolute value"
}
OperatorButton { text: "log" }
OperatorButton {
text: "cos"
Accessible.name: "cosine"
}
DigitButton {
text: "e"
dimmable: true
implicitWidth: 48
}
OperatorButton { text: "ln" }
OperatorButton { text: "tan" }
DigitButton {
text: "π"
dimmable: true
implicitWidth: 48
}
}
GridLayout {
id: mainGrid
columns: 5
columnSpacing: controller.spacing
rowSpacing: controller.spacing
BackspaceButton {
onClicked: {
controller.applicationState.operatorPressed(this.text);
controller.updateDimmed();
}
}
DigitButton { text: "7" }
DigitButton { text: "8" }
DigitButton { text: "9" }
OperatorButton {
text: "÷"
implicitWidth: 38
}
OperatorButton {
text: "AC"
textColor: controller.backspaceRedColor
accentColor: controller.backspaceRedColor
}
DigitButton { text: "4" }
DigitButton { text: "5" }
DigitButton { text: "6" }
OperatorButton {
text: "×"
implicitWidth: 38
}
OperatorButton {
text: "="
implicitHeight: 81
Layout.rowSpan: 2
}
DigitButton { text: "1" }
DigitButton { text: "2" }
DigitButton { text: "3" }
OperatorButton {
text: "−"
implicitWidth: 38
}
OperatorButton {
text: "±"
implicitWidth: 38
}
DigitButton { text: "0" }
DigitButton {
text: "."
dimmable: true
}
OperatorButton {
text: "+"
implicitWidth: 38
}
}
} // RowLayoutDependiendo de controller.isPortraitMode, el teclado numérico contiene solo los botones de una calculadora sencilla (mainGrid), o también algunas funcionalidades más avanzadas a través de scientificGrid.
Animación de los colores del texto de los botones
En el archivo CalculatorButton.qml, los colores del texto de los botones del teclado numérico también están animados.
...
color: button.getTextColor()
Behavior on color {
ColorAnimation {
duration: 120
easing.type: Easing.OutElastic
}
}
}Los cambios de color se animan definiendo un « Behavior » en la propiedad « color ». Cuando un botón se establece en « dimmed = true », el botón aparece más oscuro. Al pulsar un botón, se ilumina en verde. Para cambiar dinámicamente la propiedad « dimmed » de todos los botones del « NumberPad », la señal « buttonPressed » llama a la función « updateDimmed() » de « NumberPad ».
function updateDimmed() {
for (let i = 0; i < mainGrid.children.length; i++) {
mainGrid.children[i].dimmed = applicationState.isButtonDisabled(mainGrid.children[i].text);
}
for (let j = 0; j < scientificGrid.children.length; j++) {
scientificGrid.children[j].dimmed = applicationState.isButtonDisabled(
scientificGrid.children[j].text);
}
}Realización de cálculos
Los archivos calculator.js y ApplicationState.qml definen el motor de la calculadora. calculator.js contiene el estado lógico de la calculadora, así como las operaciones para cambiar dicho estado. ApplicationState.qml expone esta API a través de un tipo QML.
Echemos primero un vistazo a calculator.js:
let accumulator = 0
let pendingOperator = ""
let lastButton = ""
let digits = ""accumulator, pendingOperator, lastButton, represent: el estado lógico de la calculadora.
function isOperationDisabled(op, display) {
...
}isOperationDisabled() Devuelve true si una operación op debe desactivarse, en función del estado actual del motor y de la pantalla. De lo contrario, devuelve false.
function digitPressed(op, display) {
...
}
function operatorPressed(op, display) {
...
}digitPressed() Y las funciones operatorPressed() actualizan el motor y el estado de la pantalla en función de los botones pulsados.
ApplicationState.qml expone las funciones de JavaScript definidas en ` calculator.js ` a través de una API de QML más intuitiva:
import QtQml
import "calculator.js" as CalcEnginecalculator.js se importa con el nombre CalcEngine.
QtObject {
required property Display display
function operatorPressed(operator) {
CalcEngine.operatorPressed(operator, display);
}
function digitPressed(digit) {
CalcEngine.digitPressed(digit, display);
}
function isButtonDisabled(op) {
return CalcEngine.isOperationDisabled(op, display);
}
}required property se asegura de que siempre haya una instancia de ` Display.qml ` disponible en ` ApplicationState ` con el nombre ` display`. A su vez, ` display ` se utiliza en las funciones ` operatorPressed()`, ` digitPressed() ` y ` isButtonDisabled() `.
Archivos fuente
Pruebas de interfaz gráfica de usuario con Squish
Esta aplicación incluye pruebas de interfaz gráfica de usuario (GUI) de Squish destinadas a Qt para Android. Las pruebas se realizan con Squish para Qt, están escritas en Python y se encuentran en el directorio de pruebas de la aplicación.
Al utilizar Squish para Qt en Android, asegúrate de utilizar el hook integrado de Qt y de reenviar el puerto de Squish con adb. Si te aparece el error «No se puede cargar la biblioteca» y falla el comando « dlopen », desactiva « QT_USE_TARGET_ANDROID_BUILD_DIR » en la configuración de CMake o elimínalo de « Projects->Build Settings->CMake->Current Configuration » en « Qt Creator ».
Si no dispones de una licencia de Squish, puedes obtener una versión de prueba gratuita.
Véase también Aplicaciones QML.
© 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.