From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/helpviewer-example.html | 481 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 481 insertions(+) create mode 100644 doc/html/helpviewer-example.html (limited to 'doc/html/helpviewer-example.html') diff --git a/doc/html/helpviewer-example.html b/doc/html/helpviewer-example.html new file mode 100644 index 000000000..c0b4ad5f5 --- /dev/null +++ b/doc/html/helpviewer-example.html @@ -0,0 +1,481 @@ + + + + + +Simple HTML Help Browser + + + + + + + +

Simple HTML Help Browser

+ + +

+This example implements a simple HTML help browser using +TQt's richtext capabilities. +

Header file: +

/****************************************************************************
+** $Id: qt/helpwindow.h   3.3.8   edited Jan 11 14:37 $
+**
+** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
+**
+** This file is part of an example program for TQt.  This example
+** program may be used, distributed and modified without limitation.
+**
+*****************************************************************************/
+
+#ifndef HELPWINDOW_H
+#define HELPWINDOW_H
+
+#include <qmainwindow.h>
+#include <qtextbrowser.h>
+#include <qstringlist.h>
+#include <qmap.h>
+#include <qdir.h>
+
+class TQComboBox;
+class TQPopupMenu;
+
+class HelpWindow : public TQMainWindow
+{
+    Q_OBJECT
+public:
+    HelpWindow( const TQString& home_,  const TQString& path, TQWidget* parent = 0, const char *name=0 );
+    ~HelpWindow();
+
+private slots:
+    void setBackwardAvailable( bool );
+    void setForwardAvailable( bool );
+
+    void sourceChanged( const TQString& );
+    void about();
+    void aboutTQt();
+    void openFile();
+    void newWindow();
+    void print();
+
+    void pathSelected( const TQString & );
+    void histChosen( int );
+    void bookmChosen( int );
+    void addBookmark();
+
+private:
+    void readHistory();
+    void readBookmarks();
+
+    TQTextBrowser* browser;
+    TQComboBox *pathCombo;
+    int backwardId, forwardId;
+    TQStringList history, bookmarks;
+    TQMap<int, TQString> mHistory, mBookmarks;
+    TQPopupMenu *hist, *bookm;
+
+};
+
+
+
+
+
+#endif
+
+

+ +

Implementation: +

/****************************************************************************
+** $Id: qt/helpwindow.cpp   3.3.8   edited Jan 11 14:37 $
+**
+** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
+**
+** This file is part of an example program for TQt.  This example
+** program may be used, distributed and modified without limitation.
+**
+*****************************************************************************/
+
+#include "helpwindow.h"
+#include <qstatusbar.h>
+#include <qpixmap.h>
+#include <qpopupmenu.h>
+#include <qmenubar.h>
+#include <qtoolbar.h>
+#include <qtoolbutton.h>
+#include <qiconset.h>
+#include <qfile.h>
+#include <qtextstream.h>
+#include <qstylesheet.h>
+#include <qmessagebox.h>
+#include <qfiledialog.h>
+#include <qapplication.h>
+#include <qcombobox.h>
+#include <qevent.h>
+#include <qlineedit.h>
+#include <qobjectlist.h>
+#include <qfileinfo.h>
+#include <qfile.h>
+#include <qdatastream.h>
+#include <qprinter.h>
+#include <qsimplerichtext.h>
+#include <qpainter.h>
+#include <qpaintdevicemetrics.h>
+
+#include <ctype.h>
+
+HelpWindow::HelpWindow( const TQString& home_, const TQString& _path,
+                        TQWidget* parent, const char *name )
+    : TQMainWindow( parent, name, WDestructiveClose ),
+      pathCombo( 0 )
+{
+    readHistory();
+    readBookmarks();
+
+    browser = new TQTextBrowser( this );
+
+    browser->mimeSourceFactory()->setFilePath( _path );
+    browser->setFrameStyle( TQFrame::Panel | TQFrame::Sunken );
+    connect( browser, SIGNAL( sourceChanged(const TQString& ) ),
+             this, SLOT( sourceChanged( const TQString&) ) );
+
+    setCentralWidget( browser );
+
+    if ( !home_.isEmpty() )
+        browser->setSource( home_ );
+
+    connect( browser, SIGNAL( highlighted( const TQString&) ),
+             statusBar(), SLOT( message( const TQString&)) );
+
+    resize( 640,700 );
+
+    TQPopupMenu* file = new TQPopupMenu( this );
+    file->insertItem( tr("&New Window"), this, SLOT( newWindow() ), CTRL+Key_N );
+    file->insertItem( tr("&Open File"), this, SLOT( openFile() ), CTRL+Key_O );
+    file->insertItem( tr("&Print"), this, SLOT( print() ), CTRL+Key_P );
+    file->insertSeparator();
+    file->insertItem( tr("&Close"), this, SLOT( close() ), CTRL+Key_Q );
+    file->insertItem( tr("E&xit"), qApp, SLOT( closeAllWindows() ), CTRL+Key_X );
+
+    // The same three icons are used twice each.
+    TQIconSet icon_back( TQPixmap("back.xpm") );
+    TQIconSet icon_forward( TQPixmap("forward.xpm") );
+    TQIconSet icon_home( TQPixmap("home.xpm") );
+
+    TQPopupMenu* go = new TQPopupMenu( this );
+    backwardId = go->insertItem( icon_back,
+                                 tr("&Backward"), browser, SLOT( backward() ),
+                                 CTRL+Key_Left );
+    forwardId = go->insertItem( icon_forward,
+                                tr("&Forward"), browser, SLOT( forward() ),
+                                CTRL+Key_Right );
+    go->insertItem( icon_home, tr("&Home"), browser, SLOT( home() ) );
+
+    TQPopupMenu* help = new TQPopupMenu( this );
+    help->insertItem( tr("&About"), this, SLOT( about() ) );
+    help->insertItem( tr("About &TQt"), this, SLOT( aboutTQt() ) );
+
+    hist = new TQPopupMenu( this );
+    TQStringList::Iterator it = history.begin();
+    for ( ; it != history.end(); ++it )
+        mHistory[ hist->insertItem( *it ) ] = *it;
+    connect( hist, SIGNAL( activated( int ) ),
+             this, SLOT( histChosen( int ) ) );
+
+    bookm = new TQPopupMenu( this );
+    bookm->insertItem( tr( "Add Bookmark" ), this, SLOT( addBookmark() ) );
+    bookm->insertSeparator();
+
+    TQStringList::Iterator it2 = bookmarks.begin();
+    for ( ; it2 != bookmarks.end(); ++it2 )
+        mBookmarks[ bookm->insertItem( *it2 ) ] = *it2;
+    connect( bookm, SIGNAL( activated( int ) ),
+             this, SLOT( bookmChosen( int ) ) );
+
+    menuBar()->insertItem( tr("&File"), file );
+    menuBar()->insertItem( tr("&Go"), go );
+    menuBar()->insertItem( tr( "History" ), hist );
+    menuBar()->insertItem( tr( "Bookmarks" ), bookm );
+    menuBar()->insertSeparator();
+    menuBar()->insertItem( tr("&Help"), help );
+
+    menuBar()->setItemEnabled( forwardId, FALSE);
+    menuBar()->setItemEnabled( backwardId, FALSE);
+    connect( browser, SIGNAL( backwardAvailable( bool ) ),
+             this, SLOT( setBackwardAvailable( bool ) ) );
+    connect( browser, SIGNAL( forwardAvailable( bool ) ),
+             this, SLOT( setForwardAvailable( bool ) ) );
+
+
+    TQToolBar* toolbar = new TQToolBar( this );
+    addToolBar( toolbar, "Toolbar");
+    TQToolButton* button;
+
+    button = new TQToolButton( icon_back, tr("Backward"), "", browser, SLOT(backward()), toolbar );
+    connect( browser, SIGNAL( backwardAvailable(bool) ), button, SLOT( setEnabled(bool) ) );
+    button->setEnabled( FALSE );
+    button = new TQToolButton( icon_forward, tr("Forward"), "", browser, SLOT(forward()), toolbar );
+    connect( browser, SIGNAL( forwardAvailable(bool) ), button, SLOT( setEnabled(bool) ) );
+    button->setEnabled( FALSE );
+    button = new TQToolButton( icon_home, tr("Home"), "", browser, SLOT(home()), toolbar );
+
+    toolbar->addSeparator();
+
+    pathCombo = new TQComboBox( TRUE, toolbar );
+    connect( pathCombo, SIGNAL( activated( const TQString & ) ),
+             this, SLOT( pathSelected( const TQString & ) ) );
+    toolbar->setStretchableWidget( pathCombo );
+    setRightJustification( TRUE );
+    setDockEnabled( DockLeft, FALSE );
+    setDockEnabled( DockRight, FALSE );
+
+    pathCombo->insertItem( home_ );
+    browser->setFocus();
+
+}
+
+
+void HelpWindow::setBackwardAvailable( bool b)
+{
+    menuBar()->setItemEnabled( backwardId, b);
+}
+
+void HelpWindow::setForwardAvailable( bool b)
+{
+    menuBar()->setItemEnabled( forwardId, b);
+}
+
+
+void HelpWindow::sourceChanged( const TQString& url )
+{
+    if ( browser->documentTitle().isNull() )
+        setCaption( "TQt Example - Helpviewer - " + url );
+    else
+        setCaption( "TQt Example - Helpviewer - " + browser->documentTitle() ) ;
+
+    if ( !url.isEmpty() && pathCombo ) {
+        bool exists = FALSE;
+        int i;
+        for ( i = 0; i < pathCombo->count(); ++i ) {
+            if ( pathCombo->text( i ) == url ) {
+                exists = TRUE;
+                break;
+            }
+        }
+        if ( !exists ) {
+            pathCombo->insertItem( url, 0 );
+            pathCombo->setCurrentItem( 0 );
+            mHistory[ hist->insertItem( url ) ] = url;
+        } else
+            pathCombo->setCurrentItem( i );
+    }
+}
+
+HelpWindow::~HelpWindow()
+{
+    history =  mHistory.values();
+
+    TQFile f( TQDir::currentDirPath() + "/.history" );
+    f.open( IO_WriteOnly );
+    TQDataStream s( &f );
+    s << history;
+    f.close();
+
+    bookmarks = mBookmarks.values();
+
+    TQFile f2( TQDir::currentDirPath() + "/.bookmarks" );
+    f2.open( IO_WriteOnly );
+    TQDataStream s2( &f2 );
+    s2 << bookmarks;
+    f2.close();
+}
+
+void HelpWindow::about()
+{
+    TQMessageBox::about( this, "HelpViewer Example",
+                        "<p>This example implements a simple HTML help viewer "
+                        "using TQt's rich text capabilities</p>"
+                        "<p>It's just about 400 lines of C++ code, so don't expect too much :-)</p>"
+                        );
+}
+
+
+void HelpWindow::aboutTQt()
+{
+    TQMessageBox::aboutTQt( this, "TQBrowser" );
+}
+
+void HelpWindow::openFile()
+{
+#ifndef QT_NO_FILEDIALOG
+    TQString fn = TQFileDialog::getOpenFileName( TQString::null, TQString::null, this );
+    if ( !fn.isEmpty() )
+        browser->setSource( fn );
+#endif
+}
+
+void HelpWindow::newWindow()
+{
+    ( new HelpWindow(browser->source(), "qbrowser") )->show();
+}
+
+void HelpWindow::print()
+{
+#ifndef QT_NO_PRINTER
+    TQPrinter printer( TQPrinter::HighResolution );
+    printer.setFullPage(TRUE);
+    if ( printer.setup( this ) ) {
+        TQPainter p( &printer );
+        if( !p.isActive() ) // starting printing failed
+            return;
+        TQPaintDeviceMetrics metrics(p.device());
+        int dpiy = metrics.logicalDpiY();
+        int margin = (int) ( (2/2.54)*dpiy ); // 2 cm margins
+        TQRect view( margin, margin, metrics.width() - 2*margin, metrics.height() - 2*margin );
+        TQSimpleRichText richText( browser->text(),
+                                  TQFont(),
+                                  browser->context(),
+                                  browser->styleSheet(),
+                                  browser->mimeSourceFactory(),
+                                  view.height() );
+        richText.setWidth( &p, view.width() );
+        int page = 1;
+        do {
+            richText.draw( &p, margin, margin, view, colorGroup() );
+            view.moveBy( 0, view.height() );
+            p.translate( 0 , -view.height() );
+            p.drawText( view.right() - p.fontMetrics().width( TQString::number(page) ),
+                        view.bottom() + p.fontMetrics().ascent() + 5, TQString::number(page) );
+            if ( view.top() - margin >= richText.height() )
+                break;
+            printer.newPage();
+            page++;
+        } while (TRUE);
+    }
+#endif
+}
+
+void HelpWindow::pathSelected( const TQString &_path )
+{
+    browser->setSource( _path );
+    if ( mHistory.values().contains(_path) )
+        mHistory[ hist->insertItem( _path ) ] = _path;
+}
+
+void HelpWindow::readHistory()
+{
+    if ( TQFile::exists( TQDir::currentDirPath() + "/.history" ) ) {
+        TQFile f( TQDir::currentDirPath() + "/.history" );
+        f.open( IO_ReadOnly );
+        TQDataStream s( &f );
+        s >> history;
+        f.close();
+        while ( history.count() > 20 )
+            history.remove( history.begin() );
+    }
+}
+
+void HelpWindow::readBookmarks()
+{
+    if ( TQFile::exists( TQDir::currentDirPath() + "/.bookmarks" ) ) {
+        TQFile f( TQDir::currentDirPath() + "/.bookmarks" );
+        f.open( IO_ReadOnly );
+        TQDataStream s( &f );
+        s >> bookmarks;
+        f.close();
+    }
+}
+
+void HelpWindow::histChosen( int i )
+{
+    if ( mHistory.contains( i ) )
+        browser->setSource( mHistory[ i ] );
+}
+
+void HelpWindow::bookmChosen( int i )
+{
+    if ( mBookmarks.contains( i ) )
+        browser->setSource( mBookmarks[ i ] );
+}
+
+void HelpWindow::addBookmark()
+{
+    mBookmarks[ bookm->insertItem( caption() ) ] = browser->context();
+}
+

+ +

Main: +

/****************************************************************************
+** $Id: qt/main.cpp   3.3.8   edited Jan 11 14:37 $
+**
+** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
+**
+** This file is part of an example program for TQt.  This example
+** program may be used, distributed and modified without limitation.
+**
+*****************************************************************************/
+
+#include "helpwindow.h"
+#include <qapplication.h>
+#include <qdir.h>
+#include <stdlib.h>
+
+
+int main( int argc, char ** argv )
+{
+    TQApplication::setColorSpec( TQApplication::ManyColor );
+    TQApplication a(argc, argv);
+
+    TQString home;
+    if (argc > 1) {
+        home = argv[1];
+    } else {
+        // Use a hard coded path. It is only an example.
+        home = TQDir( "../../doc/html/index.html" ).absPath();
+    }
+
+    HelpWindow *help = new HelpWindow(home, ".", 0, "help viewer");
+    help->setCaption("TQt Example - Helpviewer");
+    if ( TQApplication::desktop()->width() > 400
+         && TQApplication::desktop()->height() > 500 )
+        help->show();
+    else
+        help->showMaximized();
+
+    TQObject::connect( &a, SIGNAL(lastWindowClosed()),
+                      &a, SLOT(tquit()) );
+
+    return a.exec();
+}
+

+ +