/****************************************************************************** $Id: qt/src/widgets/qtextbrowser.cpp   2.3.12   edited 2005-10-27 $**** Implementation of the QTextView class**** Created : 990101**** Copyright (C) 1992-2000 Trolltech AS.  All rights reserved.**** This file is part of the widgets module of the Qt GUI Toolkit.**** This file may be distributed under the terms of the Q Public License** as defined by Trolltech AS of Norway and appearing in the file** LICENSE.QPL included in the packaging of this file.**** This file may be distributed and/or modified under the terms of the** GNU General Public License version 2 as published by the Free Software** Foundation and appearing in the file LICENSE.GPL included in the** packaging of this file.**** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition** licenses may use this file in accordance with the Qt Commercial License** Agreement provided with the Software.**** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.**** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for**   information about Qt Commercial License Agreements.** See http://www.trolltech.com/qpl/ for QPL licensing information.** See http://www.trolltech.com/gpl/ for GPL licensing information.**** Contact info@trolltech.com if any conditions of this licensing are** not clear to you.************************************************************************/#include "qtextbrowser.h"#ifndef QT_NO_TEXTBROWSER#include "../kernel/qrichtext_p.h"#include "qapplication.h"#include "qlayout.h"#include "qpainter.h"#include "qvaluestack.h"#include "stdio.h"#include "qfile.h"#include "qtextstream.h"#include "qlayout.h"#include "qbitmap.h"#include "qtimer.h"#include "qimage.h"#include "qsimplerichtext.h"#include "qdragobject.h"#include "qurl.h"#ifdef QT_KEYPAD_MODEextern bool qt_modalEditingEnabled;#endif/*!  \class QTextBrowser qtextbrowser.h  \brief A rich text  browser with simple navigation.  \ingroup advanced  \ingroup helpsystem  This class is the same as the QTextView it inherits, with the  addition that it provides basic navigation features to follow links  in hypertext documents that link to other rich text documents. While  QTextView only allows to set its contents with setText(),  QTextBrowser has an additional function setSource(), that makes it  possible to set documents by name. These names are looked up in the  text view's mime source factory. If a document name ends with an  anchor, for example "\c #anchor", the text browser will  automatically scroll accordingly ( using scrollToAnchor() ). When  the user clicks on a hyperlink, the browser will call setSource()  itself, with the link's \c href value as argument.  QTextBrowser doesn't provide actual Back and Forward buttons, but it  has backward() and forward() slots that implement the  functionality. The home() slots brings it back to its very first  document displayed.  By using QTextView::setMimeSourceFactory(), you can provide your own  subclass of QMimeSourceFactory. This makes it possible to access  data from anywhere you need to, may it be the network or a  database. See QMimeSourceFactory::data() for details.  If you intend to use the mime factory to read the data directly from  the file system, you may have to specify the encoding for the file  extension you are using. For example  \code  mimeSourceFactory()->setExtensionType("qml", "text/utf8");  \endcode  Otherwise, the factory will not be able to resolve the document names.  For simpler richt text use, see QLabel, QTextView or QSimpleRichText.  <img src=qtextbrowser-m.png> <img src=qtextbrowser-w.png>*/class QTextBrowserData{public:    QString searchPath;    QString buttonDown;    QString highlight;    QPoint lastClick;    QValueStack<QString> stack;    QValueStack<QString> forwardStack;    QString home;    QString curmain;    QString curmark;#ifdef QT_KEYPAD_MODE    QTextBrowserData()     {     }        QString curhref;    QtTriple curhrefstartpos;    QtTriple curhrefendpos;    QtTriple prevhrefstartpos;#endif};/*!  Constructs an empty QTextBrowser.*/QTextBrowser::QTextBrowser(QWidget *parent, const char *name)    : QTextView( parent, name ){    d = new QTextBrowserData;    viewport()->setMouseTracking( TRUE );//     viewport()->setAcceptDrops( TRUE );}/*!  Destructs the browser.*/QTextBrowser::~QTextBrowser(){    delete d;}/*!  Sets the text document with the given \a name to be displayed.  The  name is looked up in the mimeSourceFactory() of the browser.  In addition to the factory lookup, this functions also checks for  optional anchors and scrolls the document accordingly.  If the first tag in the document is \c &lt;qt \c type=detail&gt;, it is  displayed as a popup rather than as new document in the browser  window itself. Otherwise, the document is set normally via  setText(), with \a name as new context.  If you are using the filesystem access capabilities of the mime  source factory, you have to ensure that the factory knows about the  encoding of specified text files, otherwise no data will be  available. The default factory handles a couple of common file  extensions such as \c *.html and \c *.txt with reasonable defaults. See  QMimeSourceFactory::data() for details.*/void QTextBrowser::setSource(const QString& name){#ifndef QT_NO_CURSOR    if ( isVisible() )	qApp->setOverrideCursor( waitCursor );#endif    QString source = name;    QString mark;    int hash = name.find('#');    if ( hash != -1) {	source  = name.left( hash );	mark = name.mid( hash+1 );    }    if ( source.left(5) == "file:" )	source = source.mid(6);    QString url = mimeSourceFactory()->makeAbsolute( source, context() );    QString txt;    bool dosettext = FALSE;    if ( !source.isEmpty() && url != d->curmain ) {	const QMimeSource* m =		    mimeSourceFactory()->data( source, context() );	if ( !m ){	    qWarning("QTextBrowser: no mimesource for %s", source.latin1() );	}	else {	    if ( !QTextDrag::decode( m, txt ) ) {		qWarning("QTextBrowser: cannot decode %s", source.latin1() );	    }	} 	if ( isVisible() ) { 	    QString firstTag = txt.left( txt.find('>' )+1 ); 	    QRichText* tmp = new QRichText( firstTag, QApplication::font() ); 	    static QString s_type = QString::fromLatin1("type"); 	    static QString s_detail = QString::fromLatin1("detail");	    bool doReturn = FALSE; 	    if ( tmp->attributes().contains(s_type)		 && tmp->attributes()[s_type] == s_detail )		doReturn = TRUE;	    QTextFormatCollection* formats = tmp->formats;	    delete tmp;	    delete formats; //#### fix inheritance structure in rich text	    if ( doReturn ) { 		popupDetail( txt, d->lastClick );#ifndef QT_NO_CURSOR 		qApp->restoreOverrideCursor();#endif 		return; 	    } 	}	d->curmain = url;	dosettext = TRUE;    }    d->curmark = mark;    if ( !mark.isEmpty() ) {	url += "#";	url += mark;    }    if ( !d->home )	d->home = url;    if ( d->stack.isEmpty() || d->stack.top() != url) {	d->stack.push( url );    }    int stackCount = d->stack.count();    if ( d->stack.top() == url )	stackCount--;    emit backwardAvailable( stackCount > 0 );    stackCount = d->forwardStack.count();    if ( d->forwardStack.top() == url )	stackCount--;    emit forwardAvailable( stackCount > 0 );    if ( dosettext )	setText( txt, url );    if ( isVisible() && !mark.isEmpty() )	scrollToAnchor( mark );    else	setContentsPos( 0, 0 );#ifndef QT_NO_CURSOR    if ( isVisible() )	qApp->restoreOverrideCursor();#endif}/*!  Returns the source of the currently display document. If no document is displayed or  the source is unknown, a null string is returned.  \sa setSource() */QString QTextBrowser::source() const{    if ( d->stack.isEmpty() )	return QString::null;    else	return d->stack.top();}/*!  Sets the contents of the browser to \a text, and emits the  textChanged() signal.*/void QTextBrowser::setText( const QString& text, const QString& context ){#ifdef QT_KEYPAD_MODE    bool hadCurrent = d->curhref.length() > 0;    d->curhref = "";#endif    QTextView::setText( text, context );#ifdef QT_KEYPAD_MODE    // select anchor if it's visible    if( !selectNextPrevHref(TRUE) && hadCurrent ) 	// no anchor to scroll to and had one previously, so notify	emit highlighted( QString::null );#endif    emit textChanged();}/*!  \fn void QTextBrowser::backwardAvailable(bool available)  This signal is emitted when the availability of the backward()  changes.  It becomes available when the user navigates forward,  and unavailable when the user is at the home().*//*!  \fn void QTextBrowser::forwardAvailable(bool available)  This signal is emitted when the availability of the forward()  changes.  It becomes available after backward() is activated,  and unavailable when the user navigates or goes forward() to  the last navigated document.*//*!  \fn void QTextBrowser::highlighted (const QString &href)  This signal is emitted when the user has selected but not activated  a link in the document.  \a href is the value of the href tag  in the link.*//*!  \fn void QTextBrowser::textChanged()  This signal is emitted whenever the setText() changes the  contents (eg. because the user clicked on a link).*//*!  Changes the document displayed to be the previous document  in the list of documents build by navigating links.  \sa forward(), backwardAvailable()*/void QTextBrowser::backward(){    if ( d->stack.count() <= 1)	return;    d->forwardStack.push( d->stack.pop() );    setSource( d->stack.pop() );    emit forwardAvailable( TRUE );}/*!  Changes the document displayed to be the next document  in the list of documents build by navigating links.  \sa backward(), forwardAvailable()*/void QTextBrowser::forward(){    if ( d->forwardStack.isEmpty() )	return;    setSource( d->forwardStack.pop() );    emit forwardAvailable( !d->forwardStack.isEmpty() );}/*!  Changes the document displayed to be the first document the  browser displayed.*/void QTextBrowser::home(){    if (!d->home.isNull() )	setSource( d->home );}/*!  Add Backward and Forward on ALT-Left and ALT-Right respectively.*/void QTextBrowser::keyPressEvent( QKeyEvent * e ){#ifdef QT_KEYPAD_MODE    switch( e->key() ) {	case Key_Select:		if ( qt_modalEditingEnabled && !isModalEditing() ) {		    setModalEditing( TRUE );		    if ( containsAnchor() )			richText().setSelectedAnchor( d->curhref, 						    d->curhrefstartpos, d->curhrefendpos );		    return;		} else if ( !d->curhref.isEmpty() ) {		    setSource( d->curhref );		    return;		} else {		    richText().setSelectedAnchor( QString::null, 						QtTriple(), QtTriple() );		    if( qt_modalEditingEnabled ) setModalEditing( FALSE );		}	    break;	case Key_Back:	case Key_No:	    if ( qt_modalEditingEnabled && isModalEditing() ) {