kurllabel.h

/* This file is part of the KDE libraries
   Copyright (C) 1998 Kurt Granroth <granroth@kde.org>
   Copyright (C) 2000 Peter Putzer <putzer@kde.org>
   Copyright (C) 2005 Jaroslaw Staniek <js@iidea.pl>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License version 2 as published by the Free Software Foundation.
 
   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 KURLLABEL_H
#define KURLLABEL_H
 
#include <tqlabel.h>
 
#include <tdelibs_export.h>
 
class TQColor;
class TQCursor;
class TQPixmap;

class TDEUI_EXPORT KURLLabel : public TQLabel
{
  TQ_OBJECT
  TQ_PROPERTY (TQString url READ url WRITE setURL)
  TQ_PROPERTY (TQString tipText READ tipText WRITE setTipText )
  TQ_PROPERTY (TQPixmap altPixmap READ altPixmap WRITE setAltPixmap)
  TQ_PROPERTY (bool glowEnabled READ isGlowEnabled WRITE setGlow )
  TQ_PROPERTY (bool floatEnabled READ isFloatEnabled WRITE setFloat )
  TQ_PROPERTY (bool useTips READ useTips WRITE setUseTips )
  TQ_PROPERTY (bool useCursor READ useCursor WRITE setUseCursor )
 
public:
  KURLLabel (TQWidget* parent = 0L, const char* name = 0L);

  KURLLabel (const TQString& url, const TQString& text = TQString::null,
              TQWidget* parent = 0L, const char* name = 0L);

  virtual ~KURLLabel ();

  const TQString& url () const;

  const TQString& tipText () const;

  bool useTips () const;

  bool useCursor () const;

  bool isGlowEnabled () const;

  bool isFloatEnabled () const;

  const TQPixmap* altPixmap () const;

  virtual void setMargin ( int margin );

#ifdef qdoc
#else
  virtual void setFocusPolicy ( TQWidget::FocusPolicy policy );
#endif

  virtual void setSizePolicy ( TQSizePolicy );
 
public slots:
  void setUnderline (bool on = true);

  void setURL (const TQString& url);

  virtual void setFont (const TQFont&);

  void setUseTips (bool on = true);

  void setTipText (const TQString& tip);

  void setHighlightedColor(const TQColor& highcolor);

  void setHighlightedColor(const TQString& highcolor);

  void setSelectedColor(const TQColor& selcolor);

  void setSelectedColor(const TQString& selcolor);

  virtual void setCursor ( const TQCursor& cursor );

  virtual void unsetCursor ();

  void setUseCursor (bool on, TQCursor* cursor = 0L);

  void setGlow (bool glow = true);

  void setFloat (bool do_float = true);

  void setAltPixmap (const TQPixmap& altPix);
 
signals:

  void enteredURL (const TQString& url);

  void enteredURL ();

  void leftURL (const TQString& url);

  void leftURL ();

  void leftClickedURL(const TQString& url);

  void leftClickedURL();

  void rightClickedURL(const TQString& url);

  void rightClickedURL();

  void middleClickedURL(const TQString& url);

  void middleClickedURL();
 
protected:

  virtual void mouseReleaseEvent ( TQMouseEvent * e );

  virtual void enterEvent (TQEvent*);

  virtual void leaveEvent (TQEvent*);

  virtual bool event (TQEvent *e);

  TQRect activeRect() const;
 
 
private slots:
  void updateColor ();
 
private:
  void setLinkColor (const TQColor& col);
 
protected:
  virtual void virtual_hook( int id, void* data );
private:
  class Private;
  Private* d;
};
 
#endif // KURLLABEL_H