tdelibs/kdeui/ktextbrowser.h

134 lines
3.6 KiB

/* This file is part of the KDE Libraries
* Copyright (C) 1999 Espen Sand (espensa@online.no)
*
* 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 _KTEXT_BROWSER_H_
#define _KTEXT_BROWSER_H_
#include <tqtextbrowser.h>
#include <kdelibs_export.h>
/**
* @short Extended TQTextBrowser.
*
* An extended TQTextBrowser.
*
* 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.
*
* \image html ktextbrowser.png "KDE Text Browser"
*
* @author Espen Sand (espensa@online.no)
*/
class KDEUI_EXPORT KTextBrowser : public TQTextBrowser
{
Q_OBJECT
Q_PROPERTY( bool notifyClick READ isNotifyClick WRITE setNotifyClick )
public:
/**
* Constructor.
*
* @param parent Parent of the widget.
* @param name Widget name.
* @param notifyClick @p true causes signals to be emitted.
*/
KTextBrowser( TQWidget *parent=0, const char *name=0,
bool notifyClick=false );
/**
* Destructor.
*/
~KTextBrowser( void );
/**
* 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.
Do not call.
*/
void setSource(const TQString& name);
/**
* Makes sure Key_Escape is ignored
*/
virtual void keyPressEvent(TQKeyEvent *e);
/**
* Make sure we use our own hand cursor
*/
virtual void viewportMouseMoveEvent( TQMouseEvent* e);
/**
* Reimplemented to support Qt2 behavior (Ctrl-Wheel = fast scroll)
*/
virtual void contentsWheelEvent( TQWheelEvent *e );
/**
* Re-implemented for internal reasons. API not affected.
*
* See TQLineEdit::createPopupMenu().
*/
virtual TQPopupMenu *createPopupMenu( const TQPoint &pos );
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 TQString::null at the moment.
* @param address The destination address.
*/
void mailClick( const TQString &name, const TQString &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 TQString &url );
private:
bool mNotifyClick;
protected:
virtual void virtual_hook( int id, void* data );
private:
class KTextBrowserPrivate;
KTextBrowserPrivate *d;
};
#endif