Inicio » Forums » Desarrollo de KDE y Qt

Introducción a la programación en KDE4 - Tutorial 5 - Usar KCmdLineArgs

Diciembre 30, 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. El código
    1. main.cpp
    2. mainwindow.h
    3. mainwindow.cpp
    4. tutorial5ui.rc
  3. Explicación
    1. mainwindow.h
    2. mainwindow.cpp
    3. main.cpp
  4. Make, Instalar y Ejecutar
    1. CMakeLists.txt

Resumen
Ahora que tenemos el editor de texto con el cual podemos cargar y guardar archivos, vamos a hacer que actúe mas como

una aplicación de escritorio, permitiendo cargar archivos desde la linea de ordenes e incluso usar Abrir con

en Dolphin.

El código

main.cpp

  1. #include <KApplication>
  2. #include <KAboutData>
  3. #include <KCmdLineArgs>
  4. #include <KUrl> //nuevo
  5.  
  6. #include "mainwindow.h"
  7.  
  8. int main (int argc, char *argv[])
  9. {
  10.         KAboutData aboutData( "tutorial5", "tutorial5",
  11.                 ki18n("Tutorial 5"), "1.0",
  12.                 ki18n("A simple text area which can load and save."),
  13.                 KAboutData::License_GPL,
  14.                 ki18n("Copyright (c) 2007 Developer") );
  15.                 KCmdLineArgs::init( argc, argv, &aboutData );
  16.  
  17.         KCmdLineOptions options; //nuevo
  18.         options.add("+[file]", ki18n("Document to open")); //nuevo
  19.         KCmdLineArgs::addCmdLineOptions(options); //nuevo
  20.  
  21.         KApplication app;
  22.  
  23.         MainWindow* window = new MainWindow();
  24.         window->show();
  25.  
  26.         KCmdLineArgs *args = KCmdLineArgs::parsedArgs(); //nuevo
  27.         if(args->count()) //nuevo
  28.         {
  29.                 window->openFile(args->url(0).url()); //nuevo
  30.         }
  31.  
  32. return app.exec();
  33. }

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.         Q_OBJECT
  10.  
  11.         public:
  12.                 MainWindow(QWidget *parent=0);
  13.                 void openFile(const QString &inputFileName); //nuevo
  14.  
  15.         private:
  16.                 KTextEdit* textArea;
  17.                 void setupActions();
  18.                 QString fileName;
  19.  
  20.         private slots:
  21.                 void newFile();
  22.                 void openFile();
  23.                 void saveFile();
  24.                 void saveFileAs();
  25.                 void saveFileAs(const QString &outputFileName);
  26. };
  27.  
  28. #endif

mainwindow.cpp

  1. #include "mainwindow.h"
  2.  
  3. #include <KApplication>
  4. #include <KAction>
  5. #include <KLocale>
  6. #include <KActionCollection>
  7. #include <KStandardAction>
  8. #include <KFileDialog>
  9. #include <KMessageBox>
  10. #include <KIO/NetAccess>
  11. #include <KSaveFile>
  12. #include <QTextStream>
  13.  
  14. MainWindow::MainWindow(QWidget *parent)
  15.         : KXmlGuiWindow(parent),
  16.         fileName(QString())
  17. {
  18.         textArea = new KTextEdit;
  19.         setCentralWidget(textArea);
  20.  
  21.         setupActions();
  22. }
  23.  
  24. void MainWindow::setupActions()
  25. {
  26.         KAction* clearAction = new KAction(this);
  27.         clearAction->setText(i18n("Limpiar"));
  28.         clearAction->setIcon(KIcon("document-new"));
  29.         clearAction->setShortcut(Qt::CTRL + Qt::Key_W);
  30.         actionCollection()->addAction("limpiar", clearAction);
  31.         connect(clearAction, SIGNAL(triggered(bool)),
  32.                         textArea, SLOT(clear()));
  33.  
  34.         KStandardAction::quit(kapp, SLOT(quit()),
  35.                         actionCollection());
  36.  
  37.         KStandardAction::open(this, SLOT(openFile()),
  38.                         actionCollection());
  39.  
  40.         KStandardAction::save(this, SLOT(saveFile()),
  41.                         actionCollection());
  42.  
  43.         KStandardAction::saveAs(this, SLOT(saveFileAs()),
  44.                         actionCollection());
  45.  
  46.         KStandardAction::openNew(this, SLOT(newFile()),
  47.                         actionCollection());
  48.  
  49.         setupGUI();
  50. }
  51.  
  52. void MainWindow::newFile()
  53. {
  54.         fileName.clear();
  55.         textArea->clear();
  56. }
  57.  
  58. void MainWindow::saveFileAs(const QString &outputFileName)
  59. {
  60.         KSaveFile file(outputFileName);
  61.         file.open();
  62.  
  63.         QByteArray outputByteArray;
  64.         outputByteArray.append(textArea->toPlainText());
  65.         file.write(outputByteArray);
  66.         file.finalize();
  67.         file.close();
  68.  
  69.         fileName = outputFileName;
  70. }
  71.  
  72. void MainWindow::saveFileAs()
  73. {
  74.         saveFileAs(KFileDialog::getSaveFileName());
  75. }
  76.  
  77. void MainWindow::saveFile()
  78. {
  79.         if(!fileName.isEmpty())
  80.         {
  81.                 saveFileAs(fileName);
  82.         }
  83.         else
  84.         {
  85.                 saveFileAs();
  86.         }
  87. }
  88.  
  89. void MainWindow::openFile() //cambiado
  90. {
  91.         openFile(KFileDialog::getOpenFileName());
  92. }
  93.  
  94. void MainWindow::openFile(const QString &inputFileName) //nuevo
  95. {
  96.         QString tmpFile;
  97.         if(KIO::NetAccess::download(inputFileName, tmpFile, this))
  98.         {
  99.                 QFile file(tmpFile);
  100.                 file.open(QIODevice::ReadOnly);
  101.                 textArea->setPlainText(QTextStream(&file).readAll());
  102.                 fileName = inputFileName;
  103.  
  104.                 KIO::NetAccess::removeTempFile(tmpFile);
  105.         }
  106.         else
  107.         {
  108.                 KMessageBox::error(this,
  109.                 KIO::NetAccess::lastErrorString());
  110.         }
  111. }

tutorial5ui.rc

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE kpartgui SYSTEM "kpartgui.dtd">
  3. <gui name="tutorial5" version="1">
  4.   <ToolBar name="mainToolBar" >
  5.     <text>Main Toolbar</text>
  6.     <Action name="limpiar" />
  7.   </ToolBar>
  8.   <MenuBar>
  9.     <Menu name="file" >
  10.       <Action name="limpiar" />
  11.     </Menu>
  12.   </MenuBar>
  13. </gui>
Es idéntico al tutorialxui.rc de los dos tutoriales anteriores excepto que tutorialx ahora es tutorial5.

Explicación

mainwindow.h
Lo único que hemos añadido a partir del tutorial 4 es la función openFile que tiene como parámetro un QString.

void openFile(const QString &inputFileName);

mainwindow.cpp
No tenemos nuevo código, solo lo hemos reordenado. Todo lo de void openFile() se ha movido a void

openFile(const QString &inputFileName) excepto la llamada a KFileDialog::getOpenFileName().

De esta manera, podemos llamar a openFile() si queremos mostrar un diálogo, o podemos llamar a

openFile(QString) si ya conocemos el nombre del archivo.

main.cpp
Aqui es donde la clase KCmdLineArgs realiza todo el trabajo.

Make, Instalar y Ejecutar

  1. project(tutorial5)
  2.  
  3. find_package(KDE4 REQUIRED)
  4. include_directories( ${KDE4_INCLUDES} )
  5.  
  6. set(tutorial5_SRCS
  7.   main.cpp
  8.   mainwindow.cpp
  9. )
  10.  
  11. kde4_add_executable(tutorial5 ${tutorial5_SRCS})
  12.  
  13. target_link_libraries(tutorial5 ${KDE4_KDEUI_LIBS}
  14.                                 ${KDE4_KIO_LIBS})
  15.  
  16. install(TARGETS tutorial5 DESTINATION ${BIN_INSTALL_DIR})
  17. install( FILES tutorial5ui.rc
  18.          DESTINATION  ${DATA_INSTALL_DIR}/tutorial5 )
Con este archivo, podemos construir y ejecutar este tutorial de la misma forma que los tutoriales 3 y 4. Para

mas información, mira el tutorial 3.

  1. mkdir build && cd build
  2. cmake .. -DCMAKE_INSTALL_PREFIX=$HOME
  3. make install
  4. $HOME/bin/tutorial5

‹ Problema con signals/slots en una aplicacion PyKDE4 [SOLUCIONADO] Introducción a Plasma - Tutorial 1 - Tu primer applet ›