Difference between revisions of "Development/Tutorials/Using KXmlGuiWindow (de)"

Jump to: navigation, search
m (Weiter geht's)
m (Text replace - "<code cppqt>" to "<syntaxhighlight lang="cpp-qt">")
Line 25: Line 25:
  
 
===mainwindow.h===
 
===mainwindow.h===
<code cppqt>
+
<syntaxhighlight lang="cpp-qt">
 
#ifndef MAINWINDOW_H
 
#ifndef MAINWINDOW_H
 
#define MAINWINDOW_H
 
#define MAINWINDOW_H
Line 50: Line 50:
  
 
===mainwindow.cpp===
 
===mainwindow.cpp===
<code cppqt>
+
<syntaxhighlight lang="cpp-qt">
 
#include "mainwindow.h"
 
#include "mainwindow.h"
  
Line 69: Line 69:
 
Um dieses Fenster wirklich zu erzeugen, müssen wir ein paar Zeilen in main.cpp ändern:
 
Um dieses Fenster wirklich zu erzeugen, müssen wir ein paar Zeilen in main.cpp ändern:
 
===main.cpp===
 
===main.cpp===
<code cppqt>
+
<syntaxhighlight lang="cpp-qt">
 
#include <KApplication>
 
#include <KApplication>
 
#include <KAboutData>
 
#include <KAboutData>

Revision as of 20:31, 29 June 2011


Development/Tutorials/Using_KXmlGuiWindow


KXmlGuiWindow
Anleitungsserie   Anleitung für Anfänger
Voriges Kapitel   Anleitung 1 - Hallo Welt
Nächstes Kapitel   Anleitung 3 - KActions benutzen
Weiterführende Texte  
Navigation   Deutsche Startseite

Zusammenfassung

Dieses Kapitel führt das Kapitel First Program Tutorial fort und wird die Klasse KXmlGuiWindow einführen.

Während im vorigen Kapitel das Programm nur einen Pop-up-Dialog erzeugt hat, werden wir jetzt in einem weiteren Schritt eine funktionierende Applikation erzeugen.

Introtokdetutorial2.png

KXmlGuiWindow benutzen

Um ein benutzbares KXmlGuiWindow zu bekommen, müssen wir eine Unterklasse davon ableiten. Zu diesem Zweck werden zwei Dateien erzeugt, die den entsprechenden Code enthalten. Einmal mainwindow.cpp und zum anderen mainwindow.h. Unsere Klasse erbt von KXmlGuiWindow, weil sie XML benutzt, um zum Beispiel die Menüstruktur des Hauptprogramms zu beschreiben.

mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <KXmlGuiWindow>
#include <KTextEdit>

class MainWindow : public KXmlGuiWindow
{
  public:
    MainWindow(QWidget *parent=0);
		
  private:
    KTextEdit* textArea;
};

#endif
</code>
Zunächst leiten wir in Zeile 7 eine Klasse von KXmlGuiWindow ab: <tt>class MainWindow : public KXmlGuiWindow</tt>.

Dann deklarieren wir den Konstruktor mit <tt>MainWindow(QWidget *parent=0);</tt>.

Zuletzt deklarieren wir einen Zeiger auf das Objekt, welches den Hauptteil unseres Programms ausmacht. {{class|KTextEdit}} ist ein allgemeiner Richtext-Editor mit einigen KDE Spielereien wie cursor auto-hiding.

===mainwindow.cpp===
<syntaxhighlight lang="cpp-qt">
#include "mainwindow.h"

MainWindow::MainWindow(QWidget *parent) : KXmlGuiWindow(parent)
{
  textArea = new KTextEdit;
  setCentralWidget(textArea);
  setupGUI();
}
</code>
Als erstes müssen wir natürlich in Zeile 1 die zuvor erzeugte Header Datei einbinden, welche die Klassen-Dekleration beinhaltet.

In Zeile 5 wird der Text Editor mit einem Objekt initialisiert. Dann benutzen wir in Zeile 6 die eingebaute <tt>setCentralWidget()</tt> Funktion, die dem KXmlGuiWindow sagt, was in der zentralen Region des Fensters erscheinen soll. 

Zuletzt wird <tt>KXmlGuiWindow::setupGUI()</tt> aufgerufen. Diese Funktion macht eine ganze Menge im Hintergrund und erzeugt unter anderem die standardmäßigen Menüeinträge (Settings, Help).

==Zurück zu main.cpp==
Um dieses Fenster wirklich zu erzeugen, müssen wir ein paar Zeilen in main.cpp ändern:
===main.cpp===
<syntaxhighlight lang="cpp-qt">
#include <KApplication>
#include <KAboutData>
#include <KCmdLineArgs>

#include "mainwindow.h"

int main (int argc, char *argv[])
{
  KAboutData aboutData( "tutorial2", 0,
      ki18n("Tutorial 2"), "1.0",
      ki18n("Ein einfacher Texteditor"),
      KAboutData::License_GPL,
      ki18n("Copyright (c) 2007 Developer") );
  KCmdLineArgs::init( argc, argv, &aboutData );
  
  KApplication app;
 
  MainWindow* window = new MainWindow();
  window->show();

  return app.exec();
}
</code>
Die einzigen neuen Zeilen (im Vergleich zu Kapitel 1) sind 18 und 19. In Zeile 17 wird das <tt>MainWindow</tt> Objekt erzeugt und in Zeile 19 dargestellt.

==CMake==
Die beste Art das Programm zu erzeugen ist CMake. Die einzige Änderung zu Kapitel 1 ist, dass <tt>mainwindow.cpp</tt> zu den Quellen hinzugefügt wurde und aus <tt>tutorial1</tt> <tt>tutorial2</tt> wurde.
===CMakeLists.txt===
<code ini>
project (tutorial2)

find_package(KDE4 REQUIRED)
include_directories( ${KDE4_INCLUDES} )

set(tutorial2_SRCS 
	main.cpp
	mainwindow.cpp
)

kde4_add_executable(tutorial2 ${tutorial2_SRCS})
target_link_libraries( tutorial2 ${KDE4_KDEUI_LIBS})
</code>

===Erzeugen===
Um das Programm zu erzeugen, binden und ausführen, geben Sie 
 cmake . && make && ./tutorial2
ein

==Weiter geht's==
Jetzt können Sie mit dem Kapitel [[Development/Tutorials/Using_KActions (de)|KActions benutzen]] fortfahren.

[[Category:C++]]

Content is available under Creative Commons License SA 4.0 unless otherwise noted.