<HTML> <HEAD> <TITLE>Source: kalbum.h</TITLE> <META NAME="Generator" CONTENT="KDOC "> </HEAD> <BODY bgcolor="#ffffff" text="#000000" link="#0000ff" vlink="#000099" alink= "#ffffff"> <TABLE WIDTH="100%" BORDER="0"> <TR> <TD> <TABLE BORDER="0"> <TR><TD valign="top" align="left" cellspacing="10"> <h1>Source: kalbum.h</h1> </TD> <TD valign="top" align="right" colspan="1"></TD></TR> </TABLE> <HR> <TABLE BORDER="0"> </TABLE> </TD> <TD align="right"><TABLE BORDER="0"><TR><TD><small><A HREF="index-long.html">Annotated List</A></small></TD></TR> <TR><TD><small><A HREF="header-list.html">Files</A></small></TD></TR> <TR><TD><small><A HREF="all-globals.html">Globals</A></small></TD></TR> <TR><TD><small><A HREF="hier.html">Hierarchy</A></small></TD></TR> <TR><TD><small><A HREF="index.html">Index</A></small></TD></TR> </TABLE></TD></TR></TABLE> <pre> /*************************************************************************** kalbum.h - description ------------------- begin : Sun Sep 8 19:50:24 UTC 2002 copyright : (C) 2002 by Graham Morrison email : kalbum@paldandy.com ***************************************************************************/ /*************************************************************************** * * * This program is free software; you can redistribute it and/or modify * * it under the terms of the GNU General Public License as published by * * the Free Software Foundation; either version 2 of the License, or * * (at your option) any later version. * * * ***************************************************************************/ #ifndef KALBUM_H #define KALBUM_H #ifdef HAVE_CONFIG_H #include <config.h> #endif // include files for Qt // include files for KDE #include <kapp.h> #include <kmainwindow.h> #include <kaccel.h> #include <kaction.h> #include <kurl.h> // forward declaration of the Kalbum classes class KalbumDoc; class KalbumView; /** * The base class for Kalbum application windows. It sets up the main * window and reads the config file as well as providing a menubar, toolbar * and statusbar. An instance of KalbumView creates your center view, which is connected * to the window's Doc object. * KalbumApp reimplements the methods that KMainWindow provides for main window handling and supports * full session management as well as using KActions. * @see KMainWindow * @see KApplication * @see KConfig * * @author Source Framework Automatically Generated by KDevelop, (c) The KDevelop Team. * @version KDevelop version 1.2 code generation */ class KalbumApp : public KMainWindow { Q_OBJECT friend class KalbumView; public: /** construtor of KalbumApp, calls all init functions to create the application. */ KalbumApp(QWidget* parent=0, const char* name=0); ~KalbumApp(); /** opens a file specified by commandline option */ void openDocumentFile(const KURL& url=0); /** returns a pointer to the current document connected to the KTMainWindow instance and is used by * the View class to access the document object's methods */ KalbumDoc *getDocument() const; protected: /** save general Options like all bar positions and status as well as the geometry and the recent file list to the configuration * file */ void saveOptions(); /** read general Options again and initialize all variables like the recent file list */ void readOptions(); /** initializes the KActions of the application */ void initActions(); /** sets up the statusbar for the main window by initialzing a statuslabel. */ void initStatusBar(); /** initializes the document object of the main window that is connected to the view in initView(). * @see initView(); */ void initDocument(); /** creates the centerwidget of the KTMainWindow instance and sets it as the view */ void initView(); /** queryClose is called by KTMainWindow on each closeEvent of a window. Against the * default implementation (only returns true), this calles saveModified() on the document object to ask if the document shall * be saved if Modified; on cancel the closeEvent is rejected. * @see KTMainWindow#queryClose * @see KTMainWindow#closeEvent */ virtual bool queryClose(); /** queryExit is called by KTMainWindow when the last window of the application is going to be closed during the closeEvent(). * Against the default implementation that just returns true, this calls saveOptions() to save the settings of the last window's * properties. * @see KTMainWindow#queryExit * @see KTMainWindow#closeEvent */ virtual bool queryExit(); /** saves the window properties for each open window during session end to the session config file, including saving the currently * opened file by a temporary filename provided by KApplication. * @see KTMainWindow#saveProperties */ virtual void saveProperties(KConfig *_cfg); /** reads the session config file and restores the application's state including the last opened files and documents by reading the * temporary files saved by saveProperties() * @see KTMainWindow#readProperties */ virtual void readProperties(KConfig *_cfg); public slots: /** open a new application window by creating a new instance of KalbumApp */ void slotFileNewWindow(); /** clears the document in the actual view to reuse it as the new document */ void slotFileNew(); /** open a file and load it into the document*/ void slotFileOpen(); /** opens a file from the recent files menu */ void slotFileOpenRecent(const KURL& url); /** save a document */ void slotFileSave(); /** save a document by a new filename*/ void slotFileSaveAs(); /** asks for saving if the file is modified, then closes the actual file and window*/ void slotFileClose(); /** print the actual file */ void slotFilePrint(); /** closes all open windows by calling close() on each memberList item until the list is empty, then quits the application. * If queryClose() returns false because the user canceled the saveModified() dialog, the closing breaks. */ void slotFileQuit(); /** put the marked text/object into the clipboard and remove * it from the document */ void slotEditCut(); /** put the marked text/object into the clipboard */ void slotEditCopy(); /** paste the clipboard into the document */ void slotEditPaste(); /** toggles the toolbar */ void slotViewToolBar(); /** toggles the statusbar */ void slotViewStatusBar(); /** changes the statusbar contents for the standard label permanently, used to indicate current actions. * @param text the text that is displayed in the statusbar */ void slotStatusMsg(const QString &text); private: /** the configuration object of the application */ KConfig *config; /** view is the main widget which represents your working area. The View * class should handle all events of the view widget. It is kept empty so * you can create your view according to your application's needs by * changing the view class. */ KalbumView *view; /** doc represents your actual document and is created only once. It keeps * information such as filename and does the serialization of your files. */ KalbumDoc *doc; // KAction pointers to enable/disable actions KAction* fileNewWindow; KAction* fileNew; KAction* fileOpen; KRecentFilesAction* fileOpenRecent; KAction* fileSave; KAction* fileSaveAs; KAction* fileClose; KAction* filePrint; KAction* fileQuit; KAction* editCut; KAction* editCopy; KAction* editPaste; KToggleAction* viewToolBar; KToggleAction* viewStatusBar; }; #endif // KALBUM_H </pre> <HR> <table> <tr><td><small>Generated by: graham on paldandy on Sun Sep 8 19:50:51 2002, using kdoc 2.0a53.</small></td></tr> </table> </BODY> </HTML>