Development/Tutorials/KCmdLineArgs (es)

Argumentos para la linea de ordenes

Serie	Tutorial para principiantes
Requisitos previos	Tutorial 4 - Cargar y Guardar
Siguiente	Tutorial 6 - ### (TODO User:milliams)
Lectura avanzada	KCmdLineArgs KCmdLineOptions

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 <gui name="tutorial5"
 3      version="1"
 4      xmlns="http://www.kde.org/standards/kxmlgui/1.0"
 5      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 6      xsi:schemaLocation="http://www.kde.org/standards/kxmlgui/1.0
 7                          http://www.kde.org/standards/kxmlgui/1.0/kxmlgui.xsd" >
 8 
 9   <MenuBar>
10     <Menu name="file" >
11       <Action name="limpiar" />
12     </Menu>
13   </MenuBar>
14 
15   <ToolBar name="mainToolBar" >
16     <text>Main Toolbar</text>
17     <Action name="limpiar" />
18   </ToolBar>
19 
20 </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

CMakeLists.txt

 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.

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