kio Library API Documentation

KURLBarItem Class Reference

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

#include <kurlbar.h>

Inheritance diagram for KURLBarItem:

QListBoxPixmap List of all members.

Public Methods

 KURLBarItem (KURLBar *parent, const KURL &url, 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.

 ~KURLBarItem ()
 Destroys the item.

void setURL (const KURL &url)
 Sets url for this item.

void setIcon (const QString &icon, KIcon::Group group=KIcon::Panel)
 sets the icon for this item.

void setDescription (const QString &desc)
 Sets the description of this item that will be shown as item-text.

void setToolTip (const QString &tip)
 Sets a tooltip to be used for this item.

QSize sizeHint () const
 returns the preferred size of this item
Since:
3.1


virtual int width (const QListBox *) const
 returns the width of this item.

virtual int height (const QListBox *) const
 returns the height of this item.

const KURLurl () const
 returns the url of this item.

const QStringdescription () const
 returns the description of this item.

const QStringicon () const
 returns the icon of this item.

QString toolTip () const
 returns the tooltip of this item.

KIcon::Group iconGroup () const
 returns the icon-group of this item (determines icon-effects).

virtual const QPixmappixmap () const
 returns the pixmap of this item.

void setApplicationLocal (bool local)
 Makes this item a local or global one.

bool applicationLocal () const
 returns whether this is a global item or a local one.


Protected Methods

virtual void paint (QPainter *p)

Detailed Description

An item to be used in KURLBar / KURLBarListBox.

All the properties (url, icon, descroption, 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,
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()

Definition at line 74 of file kurlbar.cpp.

References KStdAccel::description(), KIcon::Group, setDescription(), and setIcon().

KURLBarItem::~KURLBarItem  
 

Destroys the item.

Definition at line 88 of file kurlbar.cpp.


Member Function Documentation

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 92 of file kurlbar.cpp.

References KURL::fileName(), and QString::isEmpty().

Referenced by KURLBar::editItem().

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 99 of file kurlbar.cpp.

References KIcon::DefaultState, KIcon::Group, KGlobal::iconLoader(), QString::isEmpty(), KIconLoader::loadIcon(), and KMimeType::pixmapForURL().

Referenced by KURLBar::editItem(), KURLBarItem(), and KURLBar::setIconSize().

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 111 of file kurlbar.cpp.

References KURL::fileName(), and QString::isEmpty().

Referenced by KURLBar::editItem(), and KURLBarItem().

void KURLBarItem::setToolTip const QString   tip
 

Sets a tooltip to be used for this item.

See also:
tooolTip

Definition at line 117 of file kurlbar.cpp.

QSize KURLBarItem::sizeHint  
 

returns the preferred size of this item

Since:
3.1

Definition at line 185 of file kurlbar.cpp.

References QPixmap::height(), QListBoxPixmap::height(), KURLBar::iconSize(), KURLBarListBox::isVertical(), pixmap(), KIcon::SizeMedium, QPixmap::width(), and QListBoxPixmap::width().

Referenced by height(), KURLBar::sizeHint(), and width().

int KURLBarItem::width const QListBox   const [virtual]
 

returns the width of this item.

Reimplemented from QListBoxPixmap.

Definition at line 208 of file kurlbar.cpp.

References sizeHint(), and QSize::width().

int KURLBarItem::height const QListBox   const [virtual]
 

returns the height of this item.

Reimplemented from QListBoxPixmap.

Definition at line 216 of file kurlbar.cpp.

References QSize::height(), and sizeHint().

const KURL& KURLBarItem::url   const [inline]
 

returns the url of this item.

See also:
setURL

Definition at line 106 of file kurlbar.h.

Referenced by KURLBar::currentURL(), KURLBarListBox::dragObject(), KURLBar::editItem(), KURLBar::setCurrentItem(), KURLBar::slotContextMenuRequested(), KURLBar::slotSelected(), KFileDialog::toggleSpeedbar(), and KURLBar::writeItem().

const QString& KURLBarItem::description   const [inline]
 

returns the description of this item.

See also:
setDescription

Definition at line 111 of file kurlbar.h.

Referenced by KURLBar::editItem(), and KURLBar::writeItem().

const QString& KURLBarItem::icon   const [inline]
 

returns the icon of this item.

See also:
setIcon

Definition at line 116 of file kurlbar.h.

Referenced by KURLBar::editItem(), KURLBar::setIconSize(), and KURLBar::writeItem().

QString KURLBarItem::toolTip  
 

returns the tooltip of this item.

See also:
setToolTip

Definition at line 122 of file kurlbar.cpp.

References QString::isEmpty(), and KURL::prettyURL().

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

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

See also:
setIcon

Definition at line 126 of file kurlbar.h.

References KIcon::Group.

Referenced by KURLBar::setIconSize(), and KURLBar::writeItem().

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

returns the pixmap of this item.

Definition at line 130 of file kurlbar.h.

Referenced by sizeHint().

void KURLBarItem::setApplicationLocal bool    local [inline]
 

Makes this item a local or global one.

See also:
applicationLocal

Definition at line 136 of file kurlbar.h.

Referenced by KURLBar::editItem(), and KURLBar::insertItem().

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 143 of file kurlbar.h.

Referenced by KURLBar::editItem(), and KURLBar::writeConfig().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdelibs Version 3.1.0.
Documentation copyright © 1996-2002 the KDE developers.
Generated on Wed Oct 8 12:21:37 2003 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2001