/***************************************************************************
                          kdiff.h  -  description                              
                             -------------------                                         
    begin                : Mon Feb  8 21:33:37 MET 1999
                                           
    copyright            : (C) 1999 by M. Hipp                         
    email                : Matthias.Hipp@gmx.de                                     
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   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 KDIFF_H 
#define KDIFF_H 
 

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

// include files for QT
#include <qprinter.h>
#include <qpainter.h>

// include files for KDE 
#include <kapp.h> 
#include <ktmainwindow.h> 
#include <kaccel.h>
#include <kiconloader.h>
#include <kmsgbox.h>

// application specific includes
#include "kdiffview.h"
#include "kdiffdoc.h"
/**
  * This Class is the base class for your application. It sets up the main
  * window and reads the config file as well as providing a menubar, toolbar
  * and statusbar. For the main view, an instance of class KMyappView is
  * created which creates your view.
  */
class KdiffApp : public KTMainWindow 
{    Q_OBJECT 
public: 
  /** construtor */
  KdiffApp(); 
  /** destructor */
  ~KdiffApp();

 public slots:
  /** enable menuentries/toolbar items */
   void enableCommand(int id_);
   /** disable menuentries/toolbar items */
   void disableCommand(int id_);
   /** switch argument for slot selection by menu or toolbar ID */
   void commandCallback(int id_);
   /** switch argument for Statusbar help entries on slot selection */
   void statusCallback(int id_);

protected:

  /** init() sets the Application title, reads the config file entries
    * by calling readOptions() and calls the initXX functions to set up
    * the main view items
    */
  void init();  
  /** initMenuBar creates the menu_bar and inserts the menuitems */
  void initMenuBar(); 
  /** this creates the toolbars. Change the toobar look and add more in this
    * function 
    */ 
  void initToolBars();
  /** setup the statusbar */
  void initStatusBar(); 
  /** setup the mainview*/
  void initView();
  /** resizeEvent for the main view */
  virtual void resizeEvent(QResizeEvent *evt);
  /** add filename to the recentList */
  void addRecent(const char *filename);
  /** method asks the modified flag and creates a modified dialog for saving */
  void dlgModified();
  /** overloaded for Message box on last window exit */
  bool queryExit();
  /** save the app-specific options on slotAppExit or by an Options dialog */
  void saveOptions();
  /** read the app-specific options on init() or by an Options dialog */
  void readOptions();

  protected slots:      
    /** open a new application window */
    void slotFileNewWindow();
    /** generate a new document in the actual view */
    void slotFileNew(); 
    /** open a document */
    void slotFileOpen();
    /** save a document */
    void slotFileSave(); 
    /** save a document under a different filename*/
    void slotFileSaveAs();
    /** close the actual file */
    void slotFileClose();
    /** print the actual file */
    void slotFilePrint();
    /** close the current window */
    void slotFileCloseWindow();
    /** exits the application */
    void slotAppExit();
    /** toggle the toolbar*/
    void slotViewToolBar_0(); 
    /** toggle the statusbar*/
    void slotViewStatusBar(); 
    /** change the status message to text */
    void slotStatusMsg(const char *text);
    /** change the status message of the whole statusbar temporary */
    void slotStatusHelpMsg(const char *text);

private: 
    /** menu_bar is the applications main menubar */
    KMenuBar *menu_bar;
    /** tool_bar_0 is the first toolbar. If more toolbars are needed, please
      * increase _0 to _1 etc. */
    KToolBar *tool_bar_0;
    /** status_bar is the default statusbar of the application */
    KStatusBar *status_bar;
    QPopupMenu *file_menu_recent;
    QPopupMenu *view_menu;
    /** 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. */
    KdiffView *view;
    /** doc represents your actual document and is created only once. It keeps
      * information such as filename and does the serialization of your files.
      */
    KdiffDoc *doc;    
    QStrList *recentList; 
    /** rMainGeom keeps the acutal size of your application and is used to
      * restore your last used application size. */
    QRect rMainGeom;
    /** flag if toolbar is visible or not. Used for kconfig and checking the
      * view-menu entry view toolbar. bViewStatusbar does the same for the
      * statusbar. 
      */
    bool bViewToolbar_0;
    bool bViewStatusbar;
    /** flag if view is there or not (view is deleted on "File"->"Close") */
    bool bViewEnabled;
    /** used for KConfig to store and restore menubar position. Same with
      * tool_bar_0_pos. If more menubars or toolbars are created, you should add
      * positions as well and implement them in saveOptions() and readOptions().
      */    
    KMenuBar::menuPosition menu_bar_pos;
    KToolBar::BarPosition tool_bar_0_pos; 
};   
 
#endif // KDIFF_H
 
 
 
 
 
 
 
 

Documentation generated by bantu@scotty on Mon Feb 8 21:33:38 MET 1999