• Skip to content
  • Skip to link menu
KDE 3.5 API Reference
  • KDE API Reference
  • API Reference
  • Sitemap
  • Contact Us
 

kio

KURLBarItem Class Reference

An item to be used in KURLBar / KURLBarListBox. More...

#include <kurlbar.h>

Inheritance diagram for KURLBarItem:

Inheritance graph
[legend]

List of all members.


Public Member Functions

bool applicationLocal () const
const QString & description () const
virtual int height (const QListBox *) const
const QString & icon () const
KIcon::Group iconGroup () const
bool isPersistent () const
 KURLBarItem (KURLBar *parent, const KURL &url, const QString &description=QString::null, const QString &icon=QString::null, KIcon::Group group=KIcon::Panel)
 KURLBarItem (KURLBar *parent, const KURL &url, bool persistent, const QString &description=QString::null, const QString &icon=QString::null, KIcon::Group group=KIcon::Panel)
virtual const QPixmap * pixmap () const
void setApplicationLocal (bool local)
void setDescription (const QString &desc)
void setIcon (const QString &icon, KIcon::Group group=KIcon::Panel)
void setToolTip (const QString &tip)
void setURL (const KURL &url)
QSize sizeHint () const
QString toolTip () const
const KURL & url () const
virtual int width (const QListBox *) const
 ~KURLBarItem ()

Protected Member Functions

virtual void paint (QPainter *p)
virtual void virtual_hook (int id, void *data)

Detailed Description

An item to be used in KURLBar / KURLBarListBox.

All the properties (url, icon, description, tooltip) can be changed dynamically.

Author:
Carsten Pfeiffer <pfeiffer@kde.org>
See also:
KURLBar

KURLBarListBox

Definition at line 42 of file kurlbar.h.


Constructor & Destructor Documentation

KURLBarItem::KURLBarItem ( KURLBar *  parent,
const KURL &  url,
bool  persistent,
const QString &  description = QString::null,
const QString &  icon = QString::null,
KIcon::Group  group = KIcon::Panel 
)

Creates a KURLBarItem to be used in the parent KURLBar.

You need to insert the item into the listbox manually, if you don't use KURLBar::insertItem().

If description is empty, it will try to use the filename/directory of url, which will be shown as text of the item. url will be used as tooltip, unless you set a different tip with setToolTip(). persistent specifies whether this item is a persistent item or a dynamic item, that is not saved with KURLBar::writeConfig().

Since:
3.2

Definition at line 88 of file kurlbar.cpp.

KURLBarItem::KURLBarItem ( KURLBar *  parent,
const KURL &  url,
const QString &  description = QString::null,
const QString &  icon = QString::null,
KIcon::Group  group = KIcon::Panel 
)

Creates a persistent KURLBarItem to be used in the parent KURLBar.

You need to insert the item into the listbox manually, if you don't use KURLBar::insertItem().

If description is empty, it will try to use the filename/directory of url, which will be shown as text of the item. url will be used as tooltip, unless you set a different tip with setToolTip(). persistent specifies whether this item is a persistent item or a dynamic item, that is not saved with KURLBar::writeConfig().

Definition at line 100 of file kurlbar.cpp.

KURLBarItem::~KURLBarItem (  ) 

Destroys the item.

Definition at line 123 of file kurlbar.cpp.


Member Function Documentation

bool KURLBarItem::applicationLocal (  )  const [inline]

returns whether this is a global item or a local one.

KURLBar can differentiate between global and local items (only for the current application) for easy extensiblity.

See also:
setApplicationLocal

Definition at line 167 of file kurlbar.h.

const QString& KURLBarItem::description (  )  const [inline]

returns the description of this item.

See also:
setDescription

Definition at line 132 of file kurlbar.h.

int KURLBarItem::height ( const QListBox *  lb  )  const [virtual]

returns the height of this item.

Reimplemented from QListBoxPixmap.

Definition at line 300 of file kurlbar.cpp.

const QString& KURLBarItem::icon (  )  const [inline]

returns the icon of this item.

See also:
setIcon

Definition at line 137 of file kurlbar.h.

KIcon::Group KURLBarItem::iconGroup (  )  const [inline]

returns the icon-group of this item (determines icon-effects).

See also:
setIcon

Definition at line 147 of file kurlbar.h.

bool KURLBarItem::isPersistent (  )  const

returns whether this item is persistent (via KURLBar::writeConfig() and KURLBar::readConfig()) or not.

Since:
3.2

Definition at line 308 of file kurlbar.cpp.

void KURLBarItem::paint ( QPainter *  p  )  [protected, virtual]

Reimplemented from QListBoxPixmap.

Definition at line 179 of file kurlbar.cpp.

virtual const QPixmap* KURLBarItem::pixmap (  )  const [inline, virtual]

returns the pixmap of this item.

Reimplemented from QListBoxPixmap.

Definition at line 151 of file kurlbar.h.

void KURLBarItem::setApplicationLocal ( bool  local  ) 

Makes this item a local or global one.

This has only an effect on persistent items of course.

See also:
isPersistent

applicationLocal

Definition at line 153 of file kurlbar.cpp.

void KURLBarItem::setDescription ( const QString &  desc  ) 

Sets the description of this item that will be shown as item-text.

See also:
description

Definition at line 147 of file kurlbar.cpp.

void KURLBarItem::setIcon ( const QString &  icon,
KIcon::Group  group = KIcon::Panel 
)

sets the icon for this item.

See KIconLoader for a description of the icon groups.

See also:
icon

Definition at line 135 of file kurlbar.cpp.

void KURLBarItem::setToolTip ( const QString &  tip  ) 

Sets a tooltip to be used for this item.

See also:
toolTip

Definition at line 164 of file kurlbar.cpp.

void KURLBarItem::setURL ( const KURL &  url  ) 

Sets url for this item.

Also updates the visible text to the filename/directory of the url, if no description is set.

See also:
url

Definition at line 128 of file kurlbar.cpp.

QSize KURLBarItem::sizeHint (  )  const

returns the preferred size of this item

Since:
3.1

Definition at line 269 of file kurlbar.cpp.

QString KURLBarItem::toolTip (  )  const

returns the tooltip of this item.

See also:
setToolTip

Definition at line 169 of file kurlbar.cpp.

const KURL& KURLBarItem::url (  )  const [inline]

returns the url of this item.

See also:
setURL

Definition at line 127 of file kurlbar.h.

void KURLBarItem::virtual_hook ( int  id,
void *  data 
) [protected, virtual]

Definition at line 1026 of file kurlbar.cpp.

int KURLBarItem::width ( const QListBox *  lb  )  const [virtual]

returns the width of this item.

Reimplemented from QListBoxPixmap.

Definition at line 292 of file kurlbar.cpp.


The documentation for this class was generated from the following files:
  • kurlbar.h
  • kurlbar.cpp

kio

Skip menu "kio"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

API Reference

Skip menu "API Reference"
  • dcop
  • DNSSD
  • interfaces
  • Kate
  • kconf_update
  • KDECore
  • KDED
  • kdefx
  • KDEsu
  • kdeui
  • KDocTools
  • KHTML
  • KImgIO
  • KInit
  • kio
  • kioslave
  • KJS
  • KNewStuff
  • KParts
  • KUtils
Generated for API Reference by doxygen 1.5.9
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal