/usr/include/ktextbrowser.h is in kdelibs5-dev 4:4.14.16-0ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 | /* This file is part of the KDE Libraries
* Copyright (C) 1999 Espen Sand (espensa@online.no)
* Copyright (C) 2006 Urs Wolfer <uwolfer at fwo.ch>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef KTEXTBROWSER_H
#define KTEXTBROWSER_H
#include <kdeui_export.h>
#include <QtGui/QTextBrowser>
/**
* @short Extended QTextBrowser.
*
* An extended QTextBrowser.
*
* By default it will
* invoke the system mailer or the system browser when a link is
* activated, or it can emit the signal urlClick() or mailClick()
* when a link is activated.
*
* If the link starts with the text "whatsthis:" a QWhatsThis
* box will appear and then display the rest of the text.
*
* @warning The "whatsthis:" feature is considered deprecated: it is not
* available in KDE Frameworks 5, because KDE Frameworks 5 does
* not provide KTextBrowser anymore.
*
* \image html ktextbrowser.png "KDE Text Browser"
*
* @author Espen Sand (espensa@online.no)
*/
class KDEUI_EXPORT KTextBrowser : public QTextBrowser
{
Q_OBJECT
Q_PROPERTY( bool notifyClick READ isNotifyClick WRITE setNotifyClick )
public:
/**
* Creates a new text browser.
*
* @param parent Parent of the widget.
* @param notifyClick @p true causes signals to be emitted.
*/
explicit KTextBrowser( QWidget *parent = 0, bool notifyClick = false );
/**
* Destroys the text browser.
*/
~KTextBrowser();
/**
* Decide whether a click on a link should be handled internally
* or if a signal should be emitted.
*
* @param notifyClick @p true causes signals to be emitted.
*/
void setNotifyClick( bool notifyClick );
/**
* Returns whether a click on a link should be handled internally
* or if a signal should be emitted.
*/
bool isNotifyClick() const;
protected:
/**
* Reimplemented to NOT set the source but to do the special handling
* of links being clicked. Do not call this.
*
* If you need to set an initial source url in the text browser, call
* the QTextBrowser method explicitly, like this:
* <code>myTextBrowser->QTextBrowser::setSource(url)</code>
*/
void setSource( const QUrl& name );
/**
* Makes sure Key_Escape is ignored
*/
virtual void keyPressEvent( QKeyEvent *event );
/**
* Reimplemented to support Qt2 behavior (Ctrl-Wheel = fast scroll)
*/
virtual void wheelEvent( QWheelEvent *event );
/**
* Re-implemented for internal reasons. API not affected.
*
* See QLineEdit::createPopupMenu().
*/
virtual void contextMenuEvent( QContextMenuEvent *event );
Q_SIGNALS:
/**
* Emitted when a mail link has been activated and the widget has
* been configured to emit the signal.
*
* @param name The destination name. It is QString() at the moment.
* @param address The destination address.
*/
void mailClick( const QString &name, const QString &address );
/**
* Emitted if mailClick() is not emitted and the widget has been
* configured to emit the signal.
*
* @param url The destination address.
*/
void urlClick( const QString &url );
private:
class Private;
Private* const d;
};
#endif
|