Getting Started on the Commandline/es

This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine. Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

Introducción a la Programación con Qt

Bienvenido al mundo de Qt, la herramienta multiplataforma para GUI (interfaz gráficas de usuario). En esta guía de introducción, aprenderemos temas básicos de Qt mediante la implementación de una simple aplicación Notepad (Bloc de Notas). Al terminar de leer esta guía, usted debería estar listo para ahondar en nuestras descripciones tecnológicas generales y en la documentación del API, para poder encontrar la información que necesite sobre la aplicación que esté desarrollando.

Hola Bloc de Notas

En este primer ejemplo, simplemente creamos y mostramos en el escritorio, un editor de texto dentro de un marco de ventana. Esto representa el programa más simple posible de Qt que posea GUI.

Este es el código:

#include <QApplication>
#include <QTextEdit>

int main(int argv, char **args)
{
 QApplication app(argv, args);

QTextEdit textEdit;
 textEdit.show();

return app.exec();
}

Revisemos el código línea por línea. En las primeras dos líneas, incluimos los archivos de cabecera de QApplication y QTextEdit, las cuales son las dos clases que necesitamos para este ejemplo. Todas las clases de Qt tienen un archivo de cabecera que lleva su nombre.

En la línea 6 creamos un objeto de la clase QApplication. Este objeto administra los recursos de la aplicación y es necesario para ejecutar cualquier programa de Qt que tenga GUI. Necesita argv y argc debido a que Qt acepta algunos argumentos de la línea de comandos.

En la línea 8 creamos un objeto de la clase QTextEdit. Un editor de texto es un elemento visual en la interfaz gráfica. En Qt, estos elementos se conocen con el nombre de widgets. Otros ejemplos de widgets son: barras de desplazamiento, etiquetas, y botones de radio. Un widget también puede ser un contenedor para otros widgets; un diálogo o la ventana principal de una aplicación, por ejemplo.

En la línea 9 mostramos el editor de texto en la pantalla en su propio marco de ventana. Debido a que los widgets también funcionan como contenedores (por ejemplo una QMainWindow, la cual tiene barras de herramientas, menús, una barra de estatus, y algunos otros widgets), es posible mostrar un solo widget en su propia ventana. Los widgets no son visibles por defecto, la función show() hace visibles los widgets.

En la línea 11 la QApplication entra en su ciclo de eventos. Cuando una aplicación de Qt se está ejecutando, los eventos son generados y enviados a los widgets de la aplicación. Algunos ejemplos de eventos son presionar algún botón del mouse y pulsar alguna tecla. Cuando usted escribe texto en el widget editor de texto, este recibe eventos de tecla presionada y responde dibujando el texto tecleado.

Para ejecutar la aplicación, ejecute una terminal o símbolo del sistema en (Windows), y entre al directorio en el cual tiene el archivo .cpp del programa. Los siguientes comandos de shell construyen el programa.

qmake -project
qmake
 make

Esto generará un ejecutable en el directorio part1 (note que en Windows, posiblemente tenga que utilizar nmake en lugar de make. Note, que el ejecutable estará localizado en part1/debug o part1/release). Qmake es la herramienta de construcción de proyectos de Qt, el cual, utiliza un archivo de configuración. Qmake genera este archivo por nosotros cuando le enviamos el argumento -project*. Dado el archivo de configuración (con el sufijo .pro), qmake produce un archivo make el cual, construirá el programa por usted. Más adelante veremos como escribir nuestros propios archivos .pro

h3. Aprender Más

• Widgets y Geometría de Ventanas- Widgets Diálogo y Ventana

Eventos y manejo de eventos- El Sistema de Eventos

Agregando un botón Salir (Quit)

En una aplicación real, normalmente necesitará más de un widget. Vamos ahora a agregar un QPushButton debajo del editor de texto. El botón hará que la aplicación Bloc de Notas finalice cuando sea presionado (ejemplo, se da click con el mouse).

Revisemos el código.

#include <QtGui>

int main(int argv, char **args)
{
 QApplication app(argv, args);

QWidget window;

QTextEdit *textEdit = new QTextEdit(&amp;window);
 QPushButton *quitButton = new QPushButton("Quit");

QObject::connect(quitButton, SIGNAL (clicked()), qApp, SLOT (quit()));

QVBoxLayout layout;
 layout.addWidget(textEdit);
 layout.addWidget(quitButton);

window.setLayout(&amp;layout);

window.show();

return app.exec();
}

La línea 1 incluye el archivo de cabecera QtGui, el cual contiene todas las clases de GUI de Qt.

La línea 10 utiliza el mecanismo de Signals y Slots de Qt para hacer que la aplicación termine cuando el botón Quit sea presionado. Un slot es una función que puede ser invocada en tiempo de ejecución utilizando su nombre (como una cadena de caracteres literal). Una signal es una función que invoca a los slots registrados con ella, cuando es llamada; Invocamos eso para conectar el slot con la signal y emitir la signal.

quit() es un slot de QApplication que termina la aplicación. clicked() es una signal que QPushButton emite cuando es presionado. La función estática QObject::connect() se encarga de conectar el slot a la signal. SIGNAL() y SLOT() son dos macros que reciben la firma de las funciones signal y slot a conectar. También necesitamos enviar apuntadores a los objetos que deben enviar y recibir la señal.

En la línea 12 creamos un QVBoxLayout. Como mencionamos, los widgets pueden contener otros widgets. Es posible establecer los límites (la localización y el tamaño) de los widgets hijos directamente, pero usualmente es más sencillo utilizar un layout. Un layout administra los límites de los widgets hijos. QVBoxLayout, por ejemplo, coloca los hijos en una fila vertical.

Las líneas 13 y 14 agregan el editor de texto y el botón al layout. En la línea 17, establecemos el layout sobre el widget.

Aprender Más

• Signals y slots - Signals & Slots
• Layouts - Administración de Layout, Widgets y Layouts, Ejemplos de Layout
• Los widgets que se incluyen con Qt - Galería de Widgets de Qt, Ejemplos de Widgets

Crear Una Subclase de QWidget

Cuando el usuario quiere salir de una aplicación, es muy normal mostrar un diálogo que le pregunte sobre si de verdad desea salir. En este ejemplo, crearemos una subclase de QWidget, y agregaremos un slot que conectaremos al botón Quit.

Revisemos el código:

class Notepad : public QWidget
{
 Q_OBJECT

public:
 Notepad();

private slots:
 void quit();

private:
 QTextEdit *textEdit;
 QPushButton *quitButton;
};

La macro Q_OBJECT debe estar primero en la definición de la clase, y declara nuestra clase como un QObject (Naturalmente, también debe de heredar de QObject). Un QObject añade varias capacidades a una clase normal de C++. Notablemente, el nombre de la clase y los nombres de los slots pueden ser consultados en tiempo de ejecución. También es posible consultar el tipo de los parámetros de un slot e invocarlo.

La línea 13 declara el slot quit(). Esto es sencillo utilizando la marco slots. El slot quit() ahora puede conectarse a las signals que coincidan en su firma (cualquier signal que no reciba parámetros).

En lugar de configurar la interfaz gráfica y conectar el slot en la función main(), ahora utilizamos el constructor del Bloc de Notas.

Notepad::Notepad()
{
 textEdit = new QTextEdit;
 quitButton = new QPushButton(tr("Quit"));

connect(quitButton, SIGNAL (clicked()), this, SLOT (quit()));

QVBoxLayout '''layout = new QVBoxLayout;
 layout->addWidget(textEdit);
 layout->addWidget(quitButton);

 setLayout(layout);

 setWindowTitle(tr("Notepad"));
}

Como se puede ver en la definición de la clase, utilizamos apuntadores (punteros) a nuestros QObject (textEdit y quitButton) Como regla, usted siempre debe reservar memoria para QObject en el heap y nunca copiarlos.

Ahora utilizamos la función tr() alrededor de las cadenas de texto que serán visibles por el usuario. Esta función es necesaria cuando usted desea proveer su aplicación en más de un lenguaje (ejemplo, Inglés y Chino) No entraremos en detalles aquí, pero puede consultar el enlace Qt Linguist de la tabla de aprenda más.

h3. Aprender Más

tr() e internacionalización - Manual Qt Linguist, Escribiendo Código Fuente Para Traducción, Ejemplo Hola tr(), Internacionalización con Qt

• QObjects y el Modelo de Objetos de Qt (Esto es esencial para entender Qt) - Modelo de Objetos
• qmake y el sistema de construcción de Qt - Manual qmake

Creando un archivo .pro

Para este ejemplo escribiremos nuestro archivo en lugar de utilizar la opción de qmake -project

HEADERS = notepad.h
SOURCES = notepad.cpp main.cpp

Los siguientes comandos de shell construyen el ejemplo

qmake
make

h2. Usando una QMainWindow

Muchas aplicaciones se beneficiarán del uso de un QMainWindow, la cual tiene su propio layout al cual puede agregar una barra de menús, widgets de acoplamiento (dock widgets), barras de herramientas, y una barra de estado. QMainWindow tiene un área central que puede ser ocupada por cualquier tipo de widget. En nuestro caso, vamos a ubicar nuestro editor de texto aquí.

Revisemos la nueva definición de la clase Bloc de Notas (Notepad)

#include <QtGui>

class Notepad : public QMainWindow
{
 Q_OBJECT

public:
 Notepad();

 private slots:
 void open();
 void save();
 void quit();

 private:
 QTextEdit *textEdit;

 QAction *openAction;
 QAction *saveAction;
 QAction *exitAction;

 QMenu *fileMenu;
};

Incluimos dos slots más que pueden guardar y abrir un documento. Implementaremos su funcionalidad en la siguiente sección.

A menudo, en una ventana principal (main window), el mismo slot debe ser invocado por varios widgets. Ejemplos de ello son los elementos de menú y los botones en una barra de herramientas. Para hacer esto más fácil, Qt proporciona QAction, que puede ser dada a varios widgets, y ser conectada a un slot. Por ejemplo, tanto QMenu como QToolBar pueden crear elementos de menú y botones de herramientas de las mismas QAction. En breve vamos a ver como funciona esto.

Como antes, usamos el constructor del Bloc de Notas (Notepad) para configurar la GUI.

Notepad::Notepad()
{
 saveAction = new QAction(tr("&Open"), this);
 saveAction = new QAction(tr("&Save"), this);
 exitAction = new QAction(tr("E&xit"), this);

 connect(openAction, SIGNAL (triggered()), this, SLOT (open()));
 connect(saveAction, SIGNAL (triggered()), this, SLOT (save()));
 connect(exitAction, SIGNAL (triggered()), qApp, SLOT (quit()));

 fileMenu = menuBar()->addMenu(tr("&File"));
 fileMenu->addAction(openAction);
 fileMenu->addAction(saveAction);
 fileMenu->addSeparator();
 fileMenu->addAction(exitAction);

textEdit = new QTextEdit;
 setCentralWidget(textEdit);

setWindowTitle(tr("Notepad"));
}

Las QAction son creadas con el texto que debe aparecer en los widgets a los que las adicionemos (en nuestro caso, los elementos de menú). Si también quisieramos añadirlos a una barra de herramientas, podríamos haberles dado iconos a las acciones (actions).

Cuando un elemento de menú es presionado, el elemento dispara la accion, y el respectivo slot se invocará.

Aprender Más

• Main windows y clases main window - Aplicación Main Window, Ejemplos Main Window
• Aplicaciones MDI - QMdiArea, Ejemplo MDI

Guardando y Cargando

En este ejemplo, vamos a implementar la funcionalidad de los slots open() y save() que adicionamos en el ejemplo anterior.

Vamos a iniciar con el slot open():

QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"), "",
 tr("Text Files ('''.txt);;C++ Files ('''.cpp '''.h)"));

if (fileName != "") {
 QFile file(fileName);
 if (!file.open(QIODevice::ReadOnly)) {
 QMessageBox::critical(this, tr("Error"),
 tr("Could not open file"));
 return;
 }
 QString contents = file.readAll().constData();
 textEdit->setPlainText(contents);
 file.close();
}

El primer paso es preguntar al usuario por el nombre del archivo a abrir. Qt viene con QFileDialog, éste es un dialogo con el cual el usuario puede seleccionar un archivo. La siguiente imagen muestra el dialogo en Kubuntu. La funcion estática (static) getOpenFileName() muestra un dialogo de archivos modales, y no retorna hasta que el usuario ha seleccionado un archivo. Éste retorna la ruta del archivo seleccionado, o una cadena de texto (string) vacía si el usuario cancela el diálogo.

Si tenemos un nombre de archivo, tratamos de abrirlo con open(), que devuelve verdadero (true) si el archivo se puede abrir. No vamos a entrar en el manejo de errores aquí, pero puede consultar los enlaces de la sección de aprender más. Si el archivo no se puede abrir, utilizamos QMessageBox para mostrar un diálogo con un mensaje de error (consulte la descripción de la clase QMessageBox para más detalles).

En realidad, la lectura de los datos es trivial utilizando la función readAll(), la cual devuelve todos los datos del archivo en un QByteArray. La función constData() devuelve todos los datos del arreglo (array) como un const char, QString tiene un constructor para éste. Los contenidos se pueden visualizar en el editor de texto. Luego llamamos la función close() que cierra el archivo para retornar la descripción del archivo al sistema operativo.

Ahora, vamos a pasar al slot save().

QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"), "",
 tr("Text Files ('''.txt);;C++ Files ('''.cpp '''.h)"));

if (fileName != "") {
 QFile file(fileName);
 if (!file.open(QIODevice::WriteOnly)) {
 // error message
 } else {
 QTextStream stream(&file);
 stream << textEdit->toPlainText();
 stream.flush();
 file.close();
 }
}

Cuando escribimos el contenido del editor de texto en el archivo, utillizamos la clase QTextStream, que envuelve al objeto QFile. El flujo de texto puede escribir QStrings directamente al archivo; QFile sólo acepta los datos en bruto (char) con las funciones write() de QIODevice.