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

```
#include <KApplication>
```
```
#include <KAboutData>
```
```
#include <KCmdLineArgs>
```
```
#include <KUrl> //nuevo
```
```
 
```
```
#include "mainwindow.h"
```
```
 
```
```
int main (int argc, char *argv[])
```
```
{
```

	KAboutData aboutData( "tutorial5", "tutorial5",

```
		ki18n("Tutorial 5"), "1.0",
```

		ki18n("A simple text area which can load and save."),

```
		KAboutData::License_GPL,
```

		ki18n("Copyright (c) 2007 Developer") );

		KCmdLineArgs::init( argc, argv, &aboutData );

```
 
```
```
	KCmdLineOptions options; //nuevo
```

	options.add("+[file]", ki18n("Document to open")); //nuevo

	KCmdLineArgs::addCmdLineOptions(options); //nuevo

```
 
```
```
	KApplication app;
```
```
 
```
```
	MainWindow* window = new MainWindow();
```
```
	window->show();
```
```
 
```

	KCmdLineArgs *args = KCmdLineArgs::parsedArgs(); //nuevo

```
	if(args->count()) //nuevo
```
```
	{
```

		window->openFile(args->url(0).url()); //nuevo

```
	}
```
```
 
```
```
return app.exec();
```
```
}
```

mainwindow.h

```
#ifndef MAINWINDOW_H
```
```
#define MAINWINDOW_H
```
```
 
```
```
#include <KXmlGuiWindow>
```
```
#include <KTextEdit>
```
```
 
```
```
class MainWindow : public KXmlGuiWindow
```
```
{
```
```
	Q_OBJECT
```
```
 
```
```
	public:
```
```
		MainWindow(QWidget *parent=0);
```

		void openFile(const QString &inputFileName); //nuevo

```
 
```
```
	private:
```
```
		KTextEdit* textArea;
```
```
		void setupActions();
```
```
		QString fileName;
```
```
 
```
```
	private slots:
```
```
		void newFile();
```
```
		void openFile();
```
```
		void saveFile();
```
```
		void saveFileAs();
```

		void saveFileAs(const QString &outputFileName);

```
};
```
```
 
```
```
#endif
```

mainwindow.cpp

```
#include "mainwindow.h"
```
```
 
```
```
#include <KApplication>
```
```
#include <KAction>
```
```
#include <KLocale>
```
```
#include <KActionCollection>
```
```
#include <KStandardAction>
```
```
#include <KFileDialog>
```
```
#include <KMessageBox>
```
```
#include <KIO/NetAccess>
```
```
#include <KSaveFile>
```
```
#include <QTextStream>
```
```
 
```
```
MainWindow::MainWindow(QWidget *parent)
```
```
	: KXmlGuiWindow(parent),
```
```
	fileName(QString())
```
```
{
```
```
	textArea = new KTextEdit;
```
```
	setCentralWidget(textArea);
```
```
 
```
```
	setupActions();
```
```
}
```
```
 
```
```
void MainWindow::setupActions()
```
```
{
```

	KAction* clearAction = new KAction(this);

```
	clearAction->setText(i18n("Limpiar"));
```

	clearAction->setIcon(KIcon("document-new"));

	clearAction->setShortcut(Qt::CTRL + Qt::Key_W);

	actionCollection()->addAction("limpiar", clearAction);

	connect(clearAction, SIGNAL(triggered(bool)),

```
			textArea, SLOT(clear()));
```
```
 
```

	KStandardAction::quit(kapp, SLOT(quit()),

```
			actionCollection());
```
```
 
```

	KStandardAction::open(this, SLOT(openFile()),

```
			actionCollection());
```
```
 
```

	KStandardAction::save(this, SLOT(saveFile()),

```
			actionCollection());
```
```
 
```

	KStandardAction::saveAs(this, SLOT(saveFileAs()),

```
			actionCollection());
```
```
 
```

	KStandardAction::openNew(this, SLOT(newFile()),

```
			actionCollection());
```
```
 
```
```
	setupGUI();
```
```
}
```
```
 
```
```
void MainWindow::newFile()
```
```
{
```
```
	fileName.clear();
```
```
	textArea->clear();
```
```
}
```
```
 
```

void MainWindow::saveFileAs(const QString &outputFileName)

```
{
```
```
	KSaveFile file(outputFileName);
```
```
	file.open();
```
```
 
```
```
	QByteArray outputByteArray;
```

	outputByteArray.append(textArea->toPlainText());

```
	file.write(outputByteArray);
```
```
	file.finalize();
```
```
	file.close();
```
```
 
```
```
	fileName = outputFileName;
```
```
}
```
```
 
```
```
void MainWindow::saveFileAs()
```
```
{
```

	saveFileAs(KFileDialog::getSaveFileName());

```
}
```
```
 
```
```
void MainWindow::saveFile()
```
```
{
```
```
	if(!fileName.isEmpty())
```
```
	{
```
```
		saveFileAs(fileName);
```
```
	}
```
```
	else
```
```
	{
```
```
		saveFileAs();
```
```
	}
```
```
}
```
```
 
```
```
void MainWindow::openFile() //cambiado
```
```
{
```

	openFile(KFileDialog::getOpenFileName());

```
}
```
```
 
```

void MainWindow::openFile(const QString &inputFileName) //nuevo

```
{
```
```
	QString tmpFile;
```

	if(KIO::NetAccess::download(inputFileName, tmpFile, this))

```
	{
```
```
		QFile file(tmpFile);
```
```
		file.open(QIODevice::ReadOnly);
```

		textArea->setPlainText(QTextStream(&file).readAll());

```
		fileName = inputFileName;
```
```
 
```

		KIO::NetAccess::removeTempFile(tmpFile);

```
	}
```
```
	else
```
```
	{
```
```
		KMessageBox::error(this, 
```
```
		KIO::NetAccess::lastErrorString());
```
```
	}
```
```
}
```

tutorial5ui.rc

```
<?xml version="1.0" encoding="UTF-8"?>
```
```
<gui name="tutorial5"
```
```
     version="1"
```

     xmlns="http://www.kde.org/standards/kxmlgui/1.0"

     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

     xsi:schemaLocation="http://www.kde.org/standards/kxmlgui/1.0

                         http://www.kde.org/standards/kxmlgui/1.0/kxmlgui.xsd" >

```
 
```
```
  <MenuBar>
```
```
    <Menu name="file" >
```
```
      <Action name="limpiar" />
```
```
    </Menu>
```
```
  </MenuBar>
```
```
 
```
```
  <ToolBar name="mainToolBar" >
```
```
    <text>Main Toolbar</text>
```
```
    <Action name="limpiar" />
```
```
  </ToolBar>
```
```
 
```
```
</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

```
project(tutorial5)
```
```
 
```
```
find_package(KDE4 REQUIRED)
```
```
include_directories( ${KDE4_INCLUDES} )
```
```
 
```
```
set(tutorial5_SRCS 
```
```
  main.cpp
```
```
  mainwindow.cpp
```
```
)
```
```
 
```

kde4_add_executable(tutorial5 ${tutorial5_SRCS})

```
 
```

target_link_libraries(tutorial5 ${KDE4_KDEUI_LIBS}

                                ${KDE4_KIO_LIBS})

```
 
```

install(TARGETS tutorial5 DESTINATION ${BIN_INSTALL_DIR})

```
install( FILES tutorial5ui.rc 
```

         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

Development/Tutorials/KCmdLineArgs (es)

Contents

Resumen

El código

main.cpp

mainwindow.h

mainwindow.cpp

tutorial5ui.rc

Explicación

mainwindow.h

mainwindow.cpp

main.cpp

Make, Instalar y Ejecutar

CMakeLists.txt