Development/Tutorials/KCmdLineArgs - Revision history

AnneW at 15:42, 14 July 2012

2012-07-14T15:42:24Z

Icwiener: /* Make, Install And Run */ Fix syntax highlighting.

2011-06-30T11:47:05Z

‎Make, Install And Run: Fix syntax highlighting.

Icwiener: Fix syntax highlighting.

2011-06-27T12:42:59Z

Fix syntax highlighting.

Alisha at 02:49, 18 January 2010

2010-01-18T02:49:27Z

Urwald: Using xsd instead of dtd (not state of the art) / MenuBar tag _before_ ToolBar tag as requested by xsd

2009-02-15T11:05:55Z

Using xsd instead of dtd (not state of the art) / MenuBar tag _before_ ToolBar tag as requested by xsd

Nihui: /* tutorial4ui.rc */ change the number to 5 ;)

2008-02-12T12:59:13Z

‎tutorial4ui.rc: change the number to 5 ;)

Fracktal: Chage Language Navigation Bar incorrected (from 'Saving_and_loading' to 'KCmdLineArgs')

2008-01-04T14:58:32Z

Chage Language Navigation Bar incorrected (from 'Saving_and_loading' to 'KCmdLineArgs')

Milliams: mainwindow.h/cpp

2007-12-27T16:16:39Z

mainwindow.h/cpp

Milliams: /* Abstract */ ++

2007-12-27T14:25:43Z

‎Abstract: ++

Milliams: All the code's in. This should be shorter than the last tutorial

2007-12-27T14:06:52Z

All the code's in. This should be shorter than the last tutorial

New page

{{Template:I18n/Language Navigation Bar|Development/Tutorials/Saving_and_loading}}

{{TutorialBrowser|

series=Beginner Tutorial|

name=Command line arguments (Under construction [[User:milliams]])|

pre=[[Development/Tutorials/Saving and loading|Tutorial 4 - Loading and saving]]|

next=[[Development/Tutorials/###|Tutorial 6 - ###]] (TODO [[User:milliams]])|

reading={{class|KCmdLineArgs}} {{class|KCmdLineOptions}}
}}

==Abstract==

[[image:introtokdetutorial5.png|frame|center]]

== The Code ==

===main.cpp===
<code cppqt n>
#include <KApplication>
#include <KAboutData>
#include <KCmdLineArgs>
#include <KUrl> //new

#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; //new
options.add("+[file]", ki18n("Document to open")); //new
KCmdLineArgs::addCmdLineOptions(options); //new

KApplication app;

MainWindow* window = new MainWindow();
window->show();

KCmdLineArgs *args = KCmdLineArgs::parsedArgs(); //new
if(args->count()) //new
{
window->openFile(args->url(0).url()); //new
}

return app.exec();
}
</code>

===mainwindow.h===
<code cppqt n>
#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); //new

private:
KTextEdit* textArea;
void setupActions();
QString fileName;

private slots:
void newFile();
void openFile();
void saveFile();
void saveFileAs();
void saveFileAs(const QString &outputFileName);
};

#endif
</code>

===mainwindow.cpp===
<code cppqt n>
#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("Clear"));
clearAction->setIcon(KIcon("document-new"));
clearAction->setShortcut(Qt::CTRL + Qt::Key_W);
actionCollection()->addAction("clear", 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() //changed
{
openFile(KFileDialog::getOpenFileName());
}

void MainWindow::openFile(const QString &inputFileName) //new
{
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());
}
}
</code>

===tutorial4ui.rc===
<code xml n>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE kpartgui SYSTEM "kpartgui.dtd">
<gui name="tutorial5" version="1">
<ToolBar name="mainToolBar" >
<text>Main Toolbar</text>
<Action name="clear" />
</ToolBar>
<MenuBar>
<Menu name="file" >
<Action name="clear" />
</Menu>
</MenuBar>
</gui>
</code>
This is identical to the <tt>tutorial''x''ui.rc</tt> from the last two tutorials except <tt>tutorial''x''</tt> is now <tt>tutorial5</tt>.

==Explanation==

==Make, Install And Run==

===CMakeLists.txt===
<code ini n>
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 )
</code>

With this file, the tutorial can built and run in the same way as tutorial 3 and 4. For more information, see tutorial 3.

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

==Moving On==
Now you can move on to the ### (TODO [[User:milliams]]) tutorial.

[[Category:C++]]

← Older revision		Revision as of 15:42, 14 July 2012
Line 1:		Line 1:
−	~~{{Template:I18n/Language Navigation Bar\|Development/Tutorials/KCmdLineArgs}}~~	+

	{{TutorialBrowser\|		{{TutorialBrowser\|

@@ Line 23: / Line 23: @@
 ===main.cpp===
-<code cppqt n>
+<syntaxhighlight lang="cpp-qt">
 #include <KApplication>
 #include <KAboutData>
@@ Line 57: / Line 57: @@
    return app.exec();
+}
-</code>
+</syntaxhighlight>
 ===mainwindow.h===
-<code cppqt n>
+<syntaxhighlight lang="cpp-qt">
 #ifndef MAINWINDOW_H
 #define MAINWINDOW_H
@@ Line 89: / Line 89: @@
 #endif
-</code>
+</syntaxhighlight>
 ===mainwindow.cpp===
-<code cppqt n>
+<syntaxhighlight lang="cpp-qt">
 #include "mainwindow.h"
@@ Line 205: / Line 205: @@
+   }
+}
-</code>
+</syntaxhighlight>
 ===tutorial5ui.rc===
-<code xml n>
+<syntaxhighlight lang="xml">
 <?xml version="1.0" encoding="UTF-8"?>
 <gui name="tutorial5"
@@ Line 229: / Line 229: @@
 </gui>
-</code>
+</syntaxhighlight>
 This is identical to the <tt>tutorial''x''ui.rc</tt> from the last two tutorials except <tt>tutorial''x''</tt> is now <tt>tutorial5</tt>.
@@ Line 237: / Line 237: @@
 Here we have done nothing but add a new <tt>openFile</tt> function which takes a <tt>QString</tt>
-<code cppqt>
+<syntaxhighlight lang="cpp-qt">
 void openFile(const QString &inputFileName);
-</code>
+</syntaxhighlight>
 ===mainwindow.cpp===
@@ Line 254: / Line 254: @@
 ===CMakeLists.txt===
-<code cmake n>
+<pre>
 project(tutorial5)
@@ Line 273: / Line 273: @@
 install( FILES tutorial5ui.rc
           DESTINATION  ${DATA_INSTALL_DIR}/tutorial5 )
-</code>
+</pre>
 With this file, the tutorial can built and run in the same way as tutorial 3 and 4. For more information, see tutorial 3.
+<pre>
- mkdir build && cd build
+mkdir build && cd build
- cmake .. -DCMAKE_INSTALL_PREFIX=$HOME
+cmake .. -DCMAKE_INSTALL_PREFIX=$HOME
- make install
+make install
- $HOME/bin/tutorial5
+$HOME/bin/tutorial5
+</pre>
 ==Moving On==
 Now you can move on to the ### (TODO [[User:milliams]]) tutorial.
 [[Category:C++]]

← Older revision		Revision as of 14:58, 4 January 2008
Line 1:		Line 1:
−	{{Template:I18n/Language Navigation Bar\|Development/Tutorials/~~Saving_and_loading~~}}	+	{{Template:I18n/Language Navigation Bar\|Development/Tutorials/KCmdLineArgs}}

	{{TutorialBrowser\|		{{TutorialBrowser\|

@@ Line 210: / Line 210: @@
 <code xml n>
 <?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="clear" />
+     xsi:schemaLocation="http://www.kde.org/standards/kxmlgui/1.0
-  </ToolBar>
+                         http://www.kde.org/standards/kxmlgui/1.0/kxmlgui.xsd" >
    <MenuBar>
      <Menu name="file" >
@@ Line 221: / Line 222: @@
      </Menu>
    </MenuBar>
 </gui>
 </code>

← Older revision		Revision as of 16:16, 27 December 2007
Line 227:		Line 227:
	==Explanation==		==Explanation==

		+	===mainwindow.h===

		+	Here we have done nothing but add a new <tt>openFile</tt> function which takes a <tt>QString</tt>
		+	<code cppqt>
		+	void openFile(const QString &inputFileName);
		+	</code>
		+
		+	===mainwindow.cpp===
		+
		+	There's no new code here, only rearranging. Everything from <tt>void openFile()</tt> has been moved into <tt>void openFile(const QString &inputFileName)</tt> except the call to <tt>KFileDialog::getOpenFileName()</tt>.
		+
		+	This way, we can call <tt>openFile()</tt> if we want to display a dialog, or we can call <tt>openFile(QString)</tt> if we know the name of the file already.
		+
		+	===main.cpp===
		+
		+	This is where all the {{class\|KCmdLineArgs}} magic happens.

	==Make, Install And Run==		==Make, Install And Run==

@@ Line 16: / Line 16: @@
 ==Abstract==
+Now that we have a text editor which can open and save files. We will now make the editor act more like a desktop application by enabling it to open files from command line arguments or even using ''Open with'' from within Dolphin.
 [[image:introtokdetutorial5.png|frame|center]]