1 /****************************************************************************
2 ** $Id: qt/qtextbrowser.h   3.3.8   edited Jan 11 14:39 $
3 **
4 ** Definition of the QTextBrowser class
5 **
6 ** Created : 990101
7 **
8 ** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
9 **
10 ** This file is part of the widgets module of the Qt GUI Toolkit.
11 **
12 ** This file may be distributed under the terms of the Q Public License
13 ** as defined by Trolltech ASA of Norway and appearing in the file
14 ** LICENSE.QPL included in the packaging of this file.
15 **
16 ** This file may be distributed and/or modified under the terms of the
17 ** GNU General Public License version 2 as published by the Free Software
18 ** Foundation and appearing in the file LICENSE.GPL included in the
19 ** packaging of this file.
20 **
21 ** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
22 ** licenses may use this file in accordance with the Qt Commercial License
23 ** Agreement provided with the Software.
24 **
25 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
26 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
27 **
28 ** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
29 **   information about Qt Commercial License Agreements.
30 ** See http://www.trolltech.com/qpl/ for QPL licensing information.
31 ** See http://www.trolltech.com/gpl/ for GPL licensing information.
32 **
33 ** Contact info@trolltech.com if any conditions of this licensing are
34 ** not clear to you.
35 **
36 **********************************************************************/
37 
38 #ifndef QTEXTBROWSER_H
39 #define QTEXTBROWSER_H
40 
41 #ifndef QT_H
42 #include "qptrlist.h"
43 #include "qpixmap.h"
44 #include "qcolor.h"
45 #include "qtextedit.h"
46 #endif // QT_H
47 
48 #ifndef QT_NO_TEXTBROWSER
49 
50 class QTextBrowserData;
51 
52 class Q_EXPORT QTextBrowser : public QTextEdit
53 {
54     Q_OBJECT
55     Q_PROPERTY( QString source READ source WRITE setSource )
56     Q_OVERRIDE( int undoDepth DESIGNABLE false SCRIPTABLE false )
57     Q_OVERRIDE( bool overwriteMode DESIGNABLE false SCRIPTABLE false )
58     Q_OVERRIDE( bool modified SCRIPTABLE false)
59     Q_OVERRIDE( bool readOnly DESIGNABLE false SCRIPTABLE false )
60     Q_OVERRIDE( bool undoRedoEnabled DESIGNABLE false SCRIPTABLE false )
61 
62 public:
63     QTextBrowser( QWidget* parent=0, const char* name=0 );
64     ~QTextBrowser();
65 
66     QString source() const;
67 
68 public slots:
69     virtual void setSource(const QString& name);
70     virtual void backward();
71     virtual void forward();
72     virtual void home();
73     virtual void reload();
setText(const QString & txt)74     void setText( const QString &txt ) { setText( txt, QString::null ); }
75     virtual void setText( const QString &txt, const QString &context );
76 
77 signals:
78     void backwardAvailable( bool );
79     void forwardAvailable( bool );
80     void sourceChanged( const QString& );
81     void highlighted( const QString& );
82     void linkClicked( const QString& );
83     void anchorClicked( const QString&, const QString& );
84 
85 protected:
86     void keyPressEvent( QKeyEvent * e);
87 
88 private:
89     void popupDetail( const QString& contents, const QPoint& pos );
linksEnabled()90     bool linksEnabled() const { return TRUE; }
91     void emitHighlighted( const QString &s );
92     void emitLinkClicked( const QString &s );
93     QTextBrowserData *d;
94 
95 private:	// Disabled copy constructor and operator=
96 #if defined(Q_DISABLE_COPY)
97     QTextBrowser( const QTextBrowser & );
98     QTextBrowser& operator=( const QTextBrowser & );
99 #endif
100 };
101 
102 #endif // QT_NO_TEXTBROWSER
103 
104 #endif // QTEXTBROWSER_H
105