Inicio » Forums » Desarrollo de KDE y Qt

Introducción a la programación en KDE4 - Tutorial 2 - Usando KXmlGuiWindow

Diciembre 18, 2008 por edumardo
Enviado en

Esta serie de tutoriales son una copia de lo ya traducido en TechBase por mi. En dicha página puedes encontrar la versión original y la versión traducida al español.

Contenido

  1. Resumen
  2. KXmlGuiWindow
    1. mainwindow.h
    2. mainwindow.cpp
  3. Actualizando main.cpp
  4. CMake
    1. CMakeLists.txt
    2. Compilando
  5. Avanzando

Resumen
Este tutorial continua el camino iniciado por el tutorial Hola Mundo, haciendo una introducción a la clase KXmlGuiWindow.
En el tutorial anterior, el programa mostró una "caja de diálogo" (dialog box), ahora vamos a añadir mas funcionalidad al programa.

KXmlGuiWindow
La clase KXmlGuiWindow proporciona una vista de la ventana principal con una barra de menú, una barra de herramientas, una barra de estado y un área principal en el centro del widget. La mayoría de las aplicaciones de KDE derivarán de esta clase, que proporciona una manera fácil de definir el layout del menú y la barra de herramientas mediante archivos XML (esta tecnología se llama XMLGUI). Si bien no usaremos XMLGUI en este tutorial, lo haremos en el siguiente.

Con el fin de tener un KXmlGuiWindow que pueda usarse, debemos heredar de él. Por lo que creamos dos archivos, mainwindow.cpp y mainwindow.h que contendrán nuestro código.

mainwindow.h

  1. #ifndef MAINWINDOW_H
  2. #define MAINWINDOW_H
  3.  
  4. #include <KXmlGuiWindow>
  5. #include <KTextEdit>
  6.  
  7. class MainWindow : public KXmlGuiWindow
  8. {
  9.   public:
  10.     MainWindow(QWidget *parent=0);
  11.  
  12.   private:
  13.     KTextEdit* textArea;
  14. };
  15. #endif
En primer lugar, en la línea 7, hacemos que MainWindow herede de KXmlGuiWindow con class MainWindow : public KXmlGuiWindow.
Luego declaramos el constructor con MainWindow(QWidget *parent=0);.
Y por último declaramos un puntero al objeto que compondrá la mayor parte de nuestro programa: textArea. KTextEdit es un editor genérico de texto enriquecido con algunas sutilezas de KDE, como ocultación automática del cursor.

mainwindow.cpp

  1. #include "mainwindow.h"
  2.  
  3. MainWindow::MainWindow(QWidget *parent) : KXmlGuiWindow(parent)
  4. {
  5.   textArea = new KTextEdit();
  6.   setCentralWidget(textArea);
  7.   setupGUI();
  8. }
Lo primero que tenemos que hacer es incluir el archivo de cabecera que contiene la declaración de la clase (en la línea 1).

En la línea 5, inicializamos nuestro editor de texto con un objeto. En la línea 6 usamos la función setCentralWidget() de KXmlGuiWindow para decirle a KXmlGuiWindow que debe aparecer en la sección central de la ventana.

Por último, llamamos a KXmlGuiWindow::setupGUI() que hace un montón de cosas "detrás de la escena" y crea la barra de menú por defecto (Settings, help).

Actualizando main.cpp
Con el fin de ejecutar esta ventana, necesitamos añadir unas pocas lineas a main.cpp:

  1. #include <KApplication>
  2. #include <KAboutData>
  3. #include <KCmdLineArgs>
  4.  
  5. #include "mainwindow.h"
  6.  
  7. int main (int argc, char *argv[])
  8. {
  9.         KAboutData aboutData( "tutorial2", 0,
  10.                 ki18n("Tutorial 2"), "1.0",
  11.                 ki18n("Un area de texto"),
  12.                 KAboutData::License_GPL,
  13.                 ki18n("Copyright (c) 2007") );
  14.                 KCmdLineArgs::init( argc, argv, &aboutData);
  15.  
  16.         KApplication app;
  17.  
  18.         MainWindow* window = new MainWindow();
  19.         window->show();
  20.  
  21.         return app.exec();
  22. }
Las líneas nuevas (respecto al Tutorial 1) son la 5, la 18 y la 19. En la línea 18 creamos nuestro objeto MainWindow y en la 19 lo mostramos.

CMake
La mejor manera de compilar el programa es usar CMake. Lo único que ha cambiado desde el tutorial 1 es que hemos añadido mainwindow.cpp a la lista de fuentes y hemos cambiado tutorial1 por tutorial2.

CMakeLists.txt

  1. project (tutorial2)
  2.  
  3. find_package(KDE4 REQUIRED)
  4. include_directories(${KDE4_INCLUDES})
  5.  
  6. set(tutorial2_SRCS
  7.   main.cpp
  8.   mainwindow.cpp
  9. )
  10.  
  11. kde4_add_executable(tutorial2 ${tutorial2_SRCS})
  12. target_link_libraries(tutorial2 ${KDE4_KDEUI_LIBS})

Compilando
Para compilarlo, enlazarlo y ejecutarlo, usa:

  1. mkdir build && cd build
  2. cmake ..
  3. make
  4. ./tutorial2

Avanzando
Ahora puedes continuar con el Tutorial 3 - Usar KActions.

‹ Introducción a la programación en KDE4 - Tutorial 3 - KActions y XMLGUI Usando el framework Phonon en mi aplicación [SOLUCIONADO] ›