En esta página

Primeros pasos en la programación con Qt Quick: una aplicación de alarmas

Un tutorial sobre Qt Quick basado en una aplicación de alarmas.

Este tutorial muestra cómo desarrollar una sencilla aplicación de alarmas como introducción a Qt Quick y a los controles Qt Quick.

En este tutorial podrás introducir, editar o eliminar alarmas. Una alarma puede activarse en una fecha determinada y puedes configurarla para que se repita durante una serie de días consecutivos. Esta aplicación es similar a la aplicación de alarmas que suele encontrarse en un teléfono Android.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Creación del proyecto «Alarms»

En esta sección se muestra cómo crear el proyecto en Qt Creator. Se describen los archivos generados automáticamente por Qt Creator, así como los dos archivos que el programador debe crear en Qt Creator o en algún otro editor. Estos dos últimos archivos se incluyen con el código fuente de este tutorial.

Nota: El texto de la interfaz de usuario en Qt Creator y el contenido de los archivos generados dependen de la versión de Qt Creator que utilices.

Qt Creator

La configuración de un nuevo proyecto en Qt Creator cuenta con la ayuda de un asistente que le guía paso a paso a lo largo del proceso de creación del proyecto. El asistente le solicita que introduzca los ajustes necesarios para ese tipo concreto de proyecto y crea el proyecto por usted.

Para crear el proyecto «Alarmas», selecciona « File » > « New Project » > « Application (Qt) » > Qt Quick Application > « Choose ». Escribe «alarms» en el campo « Name » y sigue las instrucciones del asistente. Utiliza « Qt Quick Application (compact)» si deseas utilizar otros sistemas de compilación distintos de CMake o versiones de Qt inferiores a la 6.

Configuración del nuevo proyecto

Configuración de la ubicación del proyecto

El asistente de la aplicación « Qt Quick » crea un proyecto que contiene los siguientes archivos fuente:

Archivo fuenteFinalidad
CMakeLists.txtEl archivo de proyecto
main.cppEl archivo principal de código C++ de la aplicación.
Main.qmlEl archivo de código QML principal de la aplicación. En este archivo instanciaremos nuestros tipos QML personalizados (AlarmDialog, AlarmModel, AlarmDelegate y TumblerDelegate).

El asistente genera el código del archivo main.cpp que se muestra a continuación. Este bloque de código habilita el escalado de alta resolución (High DPI) y declara app y engine. A continuación, el motor carga nuestro archivo QML principal.

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    QObject::connect(
            &engine, &QQmlApplicationEngine::objectCreationFailed, &app,
            []() { QCoreApplication::exit(-1); }, Qt::QueuedConnection);

Archivos fuente adicionales

Archivo fuenteFinalidad
qtquickcontrols2.confSelecciona el estilo « Material » con el tema « Dark ».
AlarmDialog.qmlDefine el cuadro de diálogo para añadir nuevas alarmas.
AlarmDelegate.qmlDefine el diseño de la pantalla principal de la aplicación.
AlarmModel.qmlDefine el « ListModel » utilizado para almacenar los datos de las alarmas.
TumblerDelegate.qmlDefine el diseño gráfico de los «Tumblers».
qml.qrcEl archivo de recursos, que contiene los nombres de los archivos fuente, excepto main.cpp y el archivo del proyecto.
qtquickcontrols2.conf

El siguiente fragmento de código muestra cómo configurar el tema de « Dark » en el estilo « Material »:

[Controls]
Style=Material
[Material]
Theme=Dark
Accent=Red
Main.qml

mainWindow, un tipo QML de « ApplicationWindow », es el elemento raíz de esta aplicación.

ApplicationWindow {
    id: window
    width: 400
    height: 500
    visible: true

El ListView alarmListView combina los datos de alarmModel con el diseño definido en alarmDelegate.

    ListView {
        id: alarmListView
        anchors.fill: parent
        model: AlarmModel {}
        delegate: AlarmDelegate {}
    }

Se pueden añadir nuevas alarmas haciendo clic en RoundButton addAlarmButton . Al hacer clic en él, se abre una pantalla de Dialog alarmDialog .

    RoundButton {
        id: addAlarmButton
        text: "+"
        anchors.bottom: alarmListView.bottom
        anchors.bottomMargin: 8
        anchors.horizontalCenter: parent.horizontalCenter
        onClicked: alarmDialog.open()
    }

    AlarmDialog {
        id: alarmDialog
        x: Math.round((parent.width - width) / 2)
        y: Math.round((parent.height - height) / 2)
        alarmModel: alarmListView.model
    }
AlarmDialog.qml

Esta ventana de diálogo cuenta con un cuadro de diálogo « RowLayout » con un campo « Tumbler » para las horas y otro para los minutos, y otro cuadro de diálogo « RowLayout » con un «Tumbler» para el día, el mes y el año.

    contentItem: RowLayout {
        RowLayout {
            id: rowTumbler

            Tumbler {
                id: hoursTumbler
                model: 24
                delegate: TumblerDelegate {
                    text: alarmDialog.formatNumber(modelData)
                }
            }
            Tumbler {
                id: minutesTumbler
                model: 60
                delegate: TumblerDelegate {
                    text: alarmDialog.formatNumber(modelData)
                }
            }
        }

        RowLayout {
            id: datePicker

            Layout.leftMargin: 20

            readonly property var days: [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]

            Tumbler {
                id: dayTumbler

                function updateModel() {
                    // Populate the model with days of the month. For example: [0, ..., 30]
                    var previousIndex = dayTumbler.currentIndex
                    var array = []
                    var newDays = datePicker.days[monthTumbler.currentIndex]
                    for (let i = 1; i <= newDays; ++i)
                        array.push(i)
                    dayTumbler.model = array
                    dayTumbler.currentIndex = Math.min(newDays - 1, previousIndex)
                }

                Component.onCompleted: updateModel()

                delegate: TumblerDelegate {
                    text: alarmDialog.formatNumber(modelData)
                }
            }
            Tumbler {
                id: monthTumbler

                onCurrentIndexChanged: dayTumbler.updateModel()

                model: 12
                delegate: TumblerDelegate {
                    text: alarmDialog.locale.standaloneMonthName(modelData, Locale.ShortFormat)
                }
            }
            Tumbler {
                id: yearTumbler

                // This array is populated with the next three years. For example: [2018, 2019, 2020]
                readonly property var years: (function() {
                    var currentYear = new Date().getFullYear()
                    return [0, 1, 2].map(function(value) { return value + currentYear; })
                })()

                model: years
                delegate: TumblerDelegate {
                    text: alarmDialog.formatNumber(modelData)
                }
            }
        }
    }
}

Si haces clic en «Aceptar» en el cuadro de diálogo, los datos introducidos se añadirán a alarmModel:

    onAccepted: {
        alarmModel.append({
            "hour": hoursTumbler.currentIndex,
            "minute": minutesTumbler.currentIndex,
            "day": dayTumbler.currentIndex + 1,
            "month": monthTumbler.currentIndex + 1,
            "year": yearTumbler.years[yearTumbler.currentIndex],
            "activated": true,
            "label": "",
            "repeat": false,
            "daysToRepeat": [
                { "dayOfWeek": 0, "repeat": false },
                { "dayOfWeek": 1, "repeat": false },
                { "dayOfWeek": 2, "repeat": false },
                { "dayOfWeek": 3, "repeat": false },
                { "dayOfWeek": 4, "repeat": false },
                { "dayOfWeek": 5, "repeat": false },
                { "dayOfWeek": 6, "repeat": false }
            ],
        })
    }
    onRejected: alarmDialog.close()
AlarmDelegate.qml

Cada alarma de la pantalla principal es un « ItemDelegate ». El « ItemDelegate » root contiene todos los campos de la pantalla principal y de la pantalla de detalles. Los campos de la pantalla de detalles solo son visibles tras hacer clic en una alarma, es decir, cuando « root.checked » tiene el valor « true ».

ItemDelegate {
    id: root
    width: parent.width
    checkable: true

    required property int index
    required property int hour
    required property int minute
    required property int day
    required property int month
    required property int year
    required property bool activated
    required property string label
    required property bool repeat
    required property list<var> daysToRepeat

    onClicked: ListView.view.currentIndex = index

    contentItem: ColumnLayout {
        spacing: 0

        RowLayout {
            ColumnLayout {
                id: dateColumn

                readonly property date alarmDate: new Date(
                    root.year, root.month - 1, root.day, root.hour, root.minute)

                Label {
                    id: timeLabel
                    font.pixelSize: (Qt.application as Application).font.pixelSize * 2
                    text: dateColumn.alarmDate.toLocaleTimeString(root.locale, Locale.ShortFormat)
                }
                RowLayout {
                    Label {
                        id: dateLabel
                        text: dateColumn.alarmDate.toLocaleDateString(root.locale, Locale.ShortFormat)
                    }
                    Label {
                        id: alarmAbout
                        text: "⸱ " + root.label
                        visible: root.label.length > 0 && !root.checked
                    }
                }
            }
            Item {
                Layout.fillWidth: true
            }
            Switch {
                checked: root.activated
                Layout.alignment: Qt.AlignTop
                onClicked: root.activated = checked
            }
        }
        CheckBox {
            id: alarmRepeat
            text: qsTr("Repeat")
            checked: root.repeat
            visible: root.checked
            onToggled: root.repeat = checked
        }
        Flow {
            visible: root.checked && root.repeat
            Layout.fillWidth: true

            Repeater {
                id: dayRepeater
                model: root.daysToRepeat
                delegate: RoundButton {
                    required property int dayOfWeek
                    required property bool repeat
                    text: Qt.locale().dayName(dayOfWeek, Locale.NarrowFormat)
                    flat: true
                    checked: repeat
                    checkable: true
                    Material.background: checked ? Material.accent : "transparent"
                    onToggled: repeat = checked
                }
            }
        }

        TextField {
            id: alarmDescriptionTextField
            placeholderText: qsTr("Enter description here")
            cursorVisible: true
            visible: root.checked
            text: root.label
            onTextEdited: root.label = text
        }
        Button {
            id: deleteAlarmButton
            text: qsTr("Delete")
            visible: root.checked
            onClicked: root.ListView.view.model.remove(root.ListView.view.currentIndex, 1)
        }
    }
}
AlarmModel.qml

Este archivo QML contiene la definición de alarmModel, el ListModel que gestiona los datos de las alarmas.

Crea cinco ListElements con alarmas de ejemplo.

import QtQuick

// Populate the model with some sample data.
ListModel {
    id: alarmModel

    ListElement {
        hour: 6
        minute: 0
        day: 2
        month: 8
        year: 2018
        activated: true
        label: "Wake up"
        repeat: true
        daysToRepeat: [
            ListElement { dayOfWeek: 0; repeat: false },
            ListElement { dayOfWeek: 1; repeat: false },
            ListElement { dayOfWeek: 2; repeat: false },
            ListElement { dayOfWeek: 3; repeat: false },
            ListElement { dayOfWeek: 4; repeat: false },
            ListElement { dayOfWeek: 5; repeat: false },
            ListElement { dayOfWeek: 6; repeat: false }
        ]
    }
    ListElement {
        hour: 6
        minute: 0
        day: 3
        month: 8
        year: 2018
        activated: true
        label: "Wake up"
        repeat: true
        daysToRepeat: [
            ListElement { dayOfWeek: 0; repeat: true },
            ListElement { dayOfWeek: 1; repeat: true },
            ListElement { dayOfWeek: 2; repeat: true },
            ListElement { dayOfWeek: 3; repeat: true },
            ListElement { dayOfWeek: 4; repeat: true },
            ListElement { dayOfWeek: 5; repeat: false },
            ListElement { dayOfWeek: 6; repeat: false }
        ]
    }
    ListElement {
        hour: 7
        minute: 0
        day: 3
        month: 8
        year: 2018
        activated: false
        label: "Exercise"
        repeat: true
        daysToRepeat: [
            ListElement { dayOfWeek: 0; repeat: true },
            ListElement { dayOfWeek: 1; repeat: true },
            ListElement { dayOfWeek: 2; repeat: true },
            ListElement { dayOfWeek: 3; repeat: true },
            ListElement { dayOfWeek: 4; repeat: true },
            ListElement { dayOfWeek: 5; repeat: true },
            ListElement { dayOfWeek: 6; repeat: true }
        ]
    }
    ListElement {
        hour: 5
        minute: 15
        day: 1
        month: 9
        year: 2018
        activated: true
        label: ""
        repeat: false
        daysToRepeat: [
            ListElement { dayOfWeek: 0; repeat: false },
            ListElement { dayOfWeek: 1; repeat: false },
            ListElement { dayOfWeek: 2; repeat: false },
            ListElement { dayOfWeek: 3; repeat: false },
            ListElement { dayOfWeek: 4; repeat: false },
            ListElement { dayOfWeek: 5; repeat: false },
            ListElement { dayOfWeek: 6; repeat: false }
        ]
    }
    ListElement {
        hour: 5
        minute: 45
        day: 3
        month: 9
        year: 2018
        activated: false
        label: ""
        repeat: false
        daysToRepeat: [
            ListElement { dayOfWeek: 0; repeat: false },
            ListElement { dayOfWeek: 1; repeat: false },
            ListElement { dayOfWeek: 2; repeat: false },
            ListElement { dayOfWeek: 3; repeat: false },
            ListElement { dayOfWeek: 4; repeat: false },
            ListElement { dayOfWeek: 5; repeat: false },
            ListElement { dayOfWeek: 6; repeat: false }
        ]
    }
}
TumblerDelegate.qml

TumblerDelegate define las propiedades gráficas de los Tumblers.

import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Material

Text {
    required property int modelData
    required property int index
    text: modelData
    color: Tumbler.tumbler.Material.foreground
    font: Tumbler.tumbler.font
    opacity: 1.0 - Math.abs(Tumbler.displacement) / (Tumbler.tumbler.visibleItemCount / 2)
    horizontalAlignment: Text.AlignHCenter
    verticalAlignment: Text.AlignVCenter
}

Cómo añadir nuevas alarmas

En la parte inferior de la pantalla de inicio, verás un botón para añadir alarmas. Haz clic en él para abrir el cuadro de diálogo «Añadir nueva alarma ».

    RoundButton {
        id: addAlarmButton
        text: "+"
        anchors.bottom: alarmListView.bottom
        anchors.bottomMargin: 8
        anchors.horizontalCenter: parent.horizontalCenter
        onClicked: alarmDialog.open()
    }

El cuadro de diálogo para nuevas alarmas:

Configuración de las alarmas

Todos los campos se rellenan utilizando tipos QML de Tumbler. Si pulsas OK, los valores seleccionados en los tumblers se escriben en alarmModel.

    contentItem: RowLayout {
        RowLayout {
            id: rowTumbler

            Tumbler {
                id: hoursTumbler
                model: 24
                delegate: TumblerDelegate {
                    text: alarmDialog.formatNumber(modelData)
                }
            }
            Tumbler {
                id: minutesTumbler
                model: 60
                delegate: TumblerDelegate {
                    text: alarmDialog.formatNumber(modelData)
                }
            }
        }

        RowLayout {
            id: datePicker

            Layout.leftMargin: 20

            readonly property var days: [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]

            Tumbler {
                id: dayTumbler

                function updateModel() {
                    // Populate the model with days of the month. For example: [0, ..., 30]
                    var previousIndex = dayTumbler.currentIndex
                    var array = []
                    var newDays = datePicker.days[monthTumbler.currentIndex]
                    for (let i = 1; i <= newDays; ++i)
                        array.push(i)
                    dayTumbler.model = array
                    dayTumbler.currentIndex = Math.min(newDays - 1, previousIndex)
                }

                Component.onCompleted: updateModel()

                delegate: TumblerDelegate {
                    text: alarmDialog.formatNumber(modelData)
                }
            }
            Tumbler {
                id: monthTumbler

                onCurrentIndexChanged: dayTumbler.updateModel()

                model: 12
                delegate: TumblerDelegate {
                    text: alarmDialog.locale.standaloneMonthName(modelData, Locale.ShortFormat)
                }
            }
            Tumbler {
                id: yearTumbler

                // This array is populated with the next three years. For example: [2018, 2019, 2020]
                readonly property var years: (function() {
                    var currentYear = new Date().getFullYear()
                    return [0, 1, 2].map(function(value) { return value + currentYear; })
                })()

                model: years
                delegate: TumblerDelegate {
                    text: alarmDialog.formatNumber(modelData)
                }
            }
        }
    }
}

Edición de alarmas

Si haces clic en una alarma concreta, puedes editarla en la pantalla de detalles.

Diferentes configuraciones de alarma para cada día

Al hacer clic en una alarma, se establece « root.checked » en « true », lo que hace que se muestren los campos de la pantalla de detalles.

visible: root.checked

Si desea que la alarma se active también otros días, marque la casilla « alarmRepeat ». El «Repeater» mostrará una casilla de selección « RoundButton » para cada día de la semana.

        Flow {
            visible: root.checked && root.repeat
            Layout.fillWidth: true

            Repeater {
                id: dayRepeater
                model: root.daysToRepeat
                delegate: RoundButton {
                    required property int dayOfWeek
                    required property bool repeat
                    text: Qt.locale().dayName(dayOfWeek, Locale.NarrowFormat)
                    flat: true
                    checked: repeat
                    checkable: true
                    Material.background: checked ? Material.accent : "transparent"
                    onToggled: repeat = checked
                }
            }
        }

Si modifica la descripción de la alarma, esta se reflejará posteriormente en la pantalla principal.

        TextField {
            id: alarmDescriptionTextField
            placeholderText: qsTr("Enter description here")
            cursorVisible: true
            visible: root.checked
            text: root.label
            onTextEdited: root.label = text
        }

Eliminación de alarmas

La pantalla de detalles (véase más arriba) cuenta con un botón para eliminar alarmas. Al marcar la casilla « onClicked », la entrada « ListElement » actual se elimina de « alarmModel ».

        Button {
            id: deleteAlarmButton
            text: qsTr("Delete")
            visible: root.checked
            onClicked: root.ListView.view.model.remove(root.ListView.view.currentIndex, 1)
        }

Próximos pasos

La aplicación no tiene código para añadir sonido o vibración a la alarma, ni almacena las alarmas en ningún formato ni base de datos. Ponte a prueba añadiendo estas funciones al proyecto. El almacenamiento de los datos podría realizarse en formato JSON.

Archivos fuente

Proyecto de ejemplo en code.qt.io

Véase también «Compatibilidad con JSON en Qt», «Todos los ejemplos de Qt» y «Ejemplos y tutoriales deQt Quick ».

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