Development/Tutorials/Using KXmlGuiWindow (se)

    From KDE TechBase
    How To Use KXmlGuiWindow
    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.