Development/Tutorials/Using KXmlGuiWindow (se)
Tutorial Series | Beginner Tutorial |
Previous | Tutorial 1 - Hello World |
What's Next | Tutorial 3 - KActions and XmlGui |
Further Reading | KXmlGuiWindow |
Abstract
Den här guiden bygger vidare på Första Guiden och kommer att introducera KXmlGuiWindow klassen.
I den föregående guiden så skapade vi en "popup" dialog, men nu så ska vi närma oss en riktig applikation.
Using KXmlGuiWindow
För att ha nytta av KXmlGuiWindow, så måste vi subklassa den. Så vi skapar två filer, mainwindow.cpp och mainwindow.h som kommer att innehålla vår kod. Vår klass ärver ifrån KXmlGuiWindow eftersom den använder sig av XML för att t.e.x. definiera applikationens menyer.
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
Först subklassar vi KXmlGuiWindowpå rad 7 med class MainWindow : public KXmlGuiWindow.
Sen deklarerar vi konstruktorn med MainWindow(QWidget *parent=0);.
Och till slut deklarerar vi en pekare till det objektet som kommer att utgöra huvuddelen av vårt program. KTextEdit är en generisk richtexteditor med lite trevliga KDE features som t.e.x. cursor auto-hiding.
mainwindow.cpp
#include "mainwindow.h"
MainWindow::MainWindow(QWidget *parent) : KXmlGuiWindow(parent)
{
textArea = new KTextEdit;
setCentralWidget(textArea);
setupGUI();
}
Först måste vi, på rad 1, inkludera header-filen som innehåller klassdeklarationen.
På rad 5, initierar vi vår texteditor med ett objekt. Sen på rad 6 så använder vi den inbyggda funktionen setCentralWidget() som talar om för KXmlGuiWindow vad som ska visas i mittensektionen på fönstret.
Till slut så anropar vi KXmlGuiWindow::setupGUI() som gör en massa "behind-the-scenes stuff" och skapar "default" menyerna (Settings, Help).
Tillbaka till main.cpp
För att faktiskt kunna köra det här fönstret så måste vi lägga till några rader i main.cpp:
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("A simple text area"),
KAboutData::License_GPL,
ki18n("Copyright (c) 2007 Developer") );
KCmdLineArgs::init( argc, argv, &aboutData );
KApplication app;
MainWindow* window = new MainWindow();
window->show();
return app.exec();
}
Dem enda nya raderna här (jämfört med första guiden) är rad 19 och 20. På rad 18, så skapar vi vårt MainWindow objekt och sen på rad 19, visar vi det.
CMake
Det bästa sättet att bygga programmet på är att använda CMake.Det enda som har förändrats sen föregående guide är att mainwindow.cpp har lagts till i källkodslistan och alla instanser av tutorial1 har blivit tutorial2.
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})
Kompilering
För att kompilera, länka och köra, använd:
cmake . && make && ./tutorial2
Fortsättning
Nu kan du fortsätta med using KActions.