hand_book.h

Linux平台下的内核及程序调试器

/* ---------------------------------------------------------------------
 * Definition of HandBook                                    hand_book.h
 * Context-sensitive help browser
 * TODO: add search + index facility
 * --------------------------------------------------------------------- 
 * This file is part of Valkyrie, a front-end for Valgrind
 * Copyright (c) 2000-2006, OpenWorks LLP <[e-mail]>
 * This program is released under the terms of the GNU GPL v.2
 * See the file LICENSE.GPL for the full license details.
 */

#ifndef __VK_HAND_BOOK_H
#define __VK_HAND_BOOK_H


#include <qcombobox.h>
#include <qmainwindow.h>
#include <qtextbrowser.h>


/* class VkTextBrowser ---------------------------------------------- */
/* Only used in order to catch 'linkClicked' signal and open a browser
   for external links. */
class VkTextBrowser :  public QTextBrowser
{
   Q_OBJECT
 public:
   VkTextBrowser ( QWidget * parent = 0, const char * name = 0 );

 public slots:
    void reload();

 private slots:
    void doLinkClicked ( const QString& link );

 private:
   bool launch_browser( const QString& url );
   bool try_launch_browser(QString browser, const QString& link);
};


/* class HandBook --------------------------------------------------- */
class HandBook : public QMainWindow
{
   Q_OBJECT
public:
   HandBook( QWidget* parent=0, const char* name="handbook" );
   ~HandBook();

   void openUrl( const QString& url );

public slots:
   void showYourself();

protected:
   void closeEvent( QCloseEvent* ce );

private slots:
   void setBackwardAvailable( bool );
   void setForwardAvailable( bool );
   void sourceChanged(const QString& url);
   void openFile();
   void print();
   void pathSelected( const QString & );
   void historyChosen( int );
   void bookmarkChosen( int );
   void addBookmark();

private:
   void save();
   void mkMenuToolBars();

private:
   QString caption;

   VkTextBrowser* browser;
   QComboBox* pathCombo;

   QMap<int, QString> mapHistory;
   QMap<int, QString> mapBookmarks;

   enum { BACKWARD=0, FORWARD=1, HOME=2 };
   QMenuBar* mainMenu;
   QPopupMenu* bookmarkMenu;
   QPopupMenu* historyMenu;
};

#endif