Development/Tutorials/Using KXmlGuiWindow (de)

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.

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

Zunächst leiten wir in Zeile 7 eine Klasse von KXmlGuiWindow ab: class MainWindow : public KXmlGuiWindow.

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

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

mainwindow.cpp

#include "mainwindow.h"

MainWindow::MainWindow(QWidget *parent) : KXmlGuiWindow(parent)
{
  textArea = new KTextEdit;
  setCentralWidget(textArea);
  setupGUI();
}

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 setCentralWidget() Funktion, die dem KXmlGuiWindow sagt, was in der zentralen Region des Fensters erscheinen soll.

Zuletzt wird KXmlGuiWindow::setupGUI() 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

#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();
}

Die einzigen neuen Zeilen (im Vergleich zu Kapitel 1) sind 18 und 19. In Zeile 17 wird das MainWindow 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 mainwindow.cpp zu den Quellen hinzugefügt wurde und aus tutorial1 tutorial2 wurde.

CMakeLists.txt

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})

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 KActions benutzen fortfahren.