Development/Tutorials/KCmdLineArgs (es): Difference between revisions

From KDE TechBase
(translation to spanish, update)
No edit summary
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:I18n/Language Navigation Bar|Development/Tutorials/KCmdLineArgs}}


{{TutorialBrowser_(es)|
{{TutorialBrowser_(es)|
Line 23: Line 22:


===main.cpp===
===main.cpp===
<code cppqt n>
<syntaxhighlight lang="cpp-qt" line>
#include <KApplication>
#include <KApplication>
#include <KAboutData>
#include <KAboutData>
Line 57: Line 56:
return app.exec();
return app.exec();
}
}
</code>
</syntaxhighlight>


===mainwindow.h===
===mainwindow.h===
<code cppqt n>
<syntaxhighlight lang="cpp-qt" line>
#ifndef MAINWINDOW_H
#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#define MAINWINDOW_H
Line 89: Line 88:


#endif
#endif
</code>
</syntaxhighlight>


===mainwindow.cpp===
===mainwindow.cpp===
<code cppqt n>
<syntaxhighlight lang="cpp-qt" line>
#include "mainwindow.h"
#include "mainwindow.h"


Line 204: Line 203:
}
}
}
}
</code>
</syntaxhighlight>


===tutorial5ui.rc===
===tutorial5ui.rc===
<code xml n>
<syntaxhighlight lang="xml" line>
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE kpartgui SYSTEM "kpartgui.dtd">
<gui name="tutorial5"
<gui name="tutorial5" version="1">
    version="1"
  <ToolBar name="mainToolBar" >
    xmlns="http://www.kde.org/standards/kxmlgui/1.0"
    <text>Main Toolbar</text>
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    <Action name="limpiar" />
    xsi:schemaLocation="http://www.kde.org/standards/kxmlgui/1.0
  </ToolBar>
                        http://www.kde.org/standards/kxmlgui/1.0/kxmlgui.xsd" >
 
   <MenuBar>
   <MenuBar>
     <Menu name="file" >
     <Menu name="file" >
Line 220: Line 220:
     </Menu>
     </Menu>
   </MenuBar>
   </MenuBar>
  <ToolBar name="mainToolBar" >
    <text>Main Toolbar</text>
    <Action name="limpiar" />
  </ToolBar>
</gui>
</gui>
</code>
</syntaxhighlight>
Es idéntico al <tt>tutorial''x''ui.rc</tt> de los dos tutoriales anteriores excepto que <tt>tutorial''x''</tt> ahora es <tt>tutorial5</tt>.
Es idéntico al <tt>tutorial''x''ui.rc</tt> de los dos tutoriales anteriores excepto que <tt>tutorial''x''</tt> ahora es <tt>tutorial5</tt>.


Line 228: Line 234:
===mainwindow.h===
===mainwindow.h===
Lo único que hemos añadido a partir del tutorial 4 es la función <tt>openFile</tt> que tiene como parámetro un <tt>QString</tt>.
Lo único que hemos añadido a partir del tutorial 4 es la función <tt>openFile</tt> que tiene como parámetro un <tt>QString</tt>.
<code cppqt>
<syntaxhighlight lang="cpp-qt">
void openFile(const QString &inputFileName);
void openFile(const QString &inputFileName);
</code>
</syntaxhighlight>


===mainwindow.cpp===
===mainwindow.cpp===
Line 245: Line 251:


===CMakeLists.txt===
===CMakeLists.txt===
<code ini n>
<syntaxhighlight lang="ini" line>
project(tutorial5)
project(tutorial5)
   
   
Line 264: Line 270:
install( FILES tutorial5ui.rc  
install( FILES tutorial5ui.rc  
         DESTINATION  ${DATA_INSTALL_DIR}/tutorial5 )
         DESTINATION  ${DATA_INSTALL_DIR}/tutorial5 )
</code>
</syntaxhighlight>


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.  
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.  

Latest revision as of 18:31, 15 July 2012

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