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


El asistente de la aplicación « Qt Quick » crea un proyecto que contiene los siguientes archivos fuente:
| Archivo fuente | Finalidad |
|---|---|
| CMakeLists.txt | El archivo de proyecto |
| main.cpp | El archivo principal de código C++ de la aplicación. |
| Main.qml | El 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 fuente | Finalidad |
|---|---|
qtquickcontrols2.conf | Selecciona el estilo « Material » con el tema « Dark ». |
AlarmDialog.qml | Define el cuadro de diálogo para añadir nuevas alarmas. |
AlarmDelegate.qml | Define el diseño de la pantalla principal de la aplicación. |
AlarmModel.qml | Define el « ListModel » utilizado para almacenar los datos de las alarmas. |
TumblerDelegate.qml | Define el diseño gráfico de los «Tumblers». |
qml.qrc | El 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=RedMain.qml
mainWindow, un tipo QML de « ApplicationWindow », es el elemento raíz de esta aplicación.
ApplicationWindow {
id: window
width: 400
height: 500
visible: trueEl 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:

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.

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