kdecore Library API Documentation

KIconTheme Class Reference

Class to use/access icon themes in KDE. More...

#include <kicontheme.h>

List of all members.

Public Methods

 KIconTheme (const QString &name, const QString &appName=QString::null)
 Load an icon theme by name.

QString name () const
 The stylized name of the icon theme.

QString description () const
 A description for the icon theme.

QString example () const
 Return the name of the "example" icon.

QString screenshot () const
 Return the name of the screenshot.

QString linkOverlay () const
 Returns the name of this theme's link overlay.

QString zipOverlay () const
 Returns the name of this theme's zip overlay.

QString lockOverlay () const
 Returns the name of this theme's lock overlay.

QString shareOverlay () const
 Returns the name of this theme's share overlay.

QString dir () const
 Returns the toplevel theme directory.

QStringList inherits () const
 The themes this icon theme falls back on.

bool isValid () const
 The icon theme exists?

bool isHidden () const
 The icon theme should be hidden to the user?

int depth () const
 The minimum display depth required for this theme.

int defaultSize (KIcon::Group group) const
 The default size of this theme for a certain icon group.

QValueList< int > querySizes (KIcon::Group group) const
 Query available sizes for a group.

QStringList queryIcons (int size, KIcon::Context context=KIcon::Any) const
 Query available icons for a size and context.

QStringList queryIconsByContext (int size, KIcon::Context context=KIcon::Any) const
 Query available icons for a context and preferred size.

KIcon iconPath (const QString &name, int size, KIcon::MatchType match) const
 Lookup an icon in the theme.


Static Public Methods

QStringList list ()
 List all icon themes installed on the system, global and local.

QString current ()
 Returns the current icon theme.

void reconfigure ()
 Reconfigure the theme.

QString defaultThemeName ()
 Returns the default icon theme.


Detailed Description

Class to use/access icon themes in KDE.

This class is used by the iconloader but can be used by others too.

See also:
KIconLoader

Definition at line 155 of file kicontheme.h.


Constructor & Destructor Documentation

KIconTheme::KIconTheme const QString   name,
const QString   appName = QString::null
 

Load an icon theme by name.

Parameters:
name  the name of the theme (e.g. "hicolor" or "keramik")
appName  the name of the application. Can be null. This argument allows applications to have themed application icons.

Definition at line 80 of file kicontheme.cpp.

References QPtrList< KIconThemeDir >::append(), QValueList::begin(), QMap::contains(), dir(), KGlobal::dirs(), QValueList::end(), KStandardDirs::exists(), QFile::exists(), QPtrList< KIconThemeDir >::first(), QString::isEmpty(), QPtrList< KIconThemeDir >::next(), KConfigBase::readBoolEntry(), KConfigBase::readEntry(), KConfigBase::readIntListEntry(), KConfigBase::readListEntry(), KConfigBase::readNumEntry(), KStandardDirs::resourceDirs(), KIcon::Scalable, QPtrList< KIconThemeDir >::setAutoDelete(), and KConfigBase::setGroup().


Member Function Documentation

QString KIconTheme::name   const [inline]
 

The stylized name of the icon theme.

Returns:
the (human-readable) name of the theme

Definition at line 171 of file kicontheme.h.

QString KIconTheme::description   const [inline]
 

A description for the icon theme.

Returns:
a human-readable description of the theme, QString::null if there is none

Definition at line 178 of file kicontheme.h.

QString KIconTheme::example  
 

Return the name of the "example" icon.

This can be used to present the theme to the user.

Returns:
the name of the example icon, QString::null if there is none

Definition at line 215 of file kicontheme.cpp.

QString KIconTheme::screenshot  
 

Return the name of the screenshot.

Returns:
the name of the screenshot, QString::null if there is none

Definition at line 216 of file kicontheme.cpp.

QString KIconTheme::linkOverlay  
 

Returns the name of this theme's link overlay.

Returns:
the name of the link overlay

Definition at line 217 of file kicontheme.cpp.

Referenced by KIconLoader::loadIcon().

QString KIconTheme::zipOverlay  
 

Returns the name of this theme's zip overlay.

Returns:
the name of the zip overlay

Definition at line 219 of file kicontheme.cpp.

Referenced by KIconLoader::loadIcon().

QString KIconTheme::lockOverlay  
 

Returns the name of this theme's lock overlay.

Returns:
the name of the lock overlay

Definition at line 218 of file kicontheme.cpp.

Referenced by KIconLoader::loadIcon().

QString KIconTheme::shareOverlay  
 

Returns the name of this theme's share overlay.

Returns:
the name of the share overlay
Since:
3.1

Definition at line 220 of file kicontheme.cpp.

Referenced by KIconLoader::loadIcon().

QString KIconTheme::dir   const [inline]
 

Returns the toplevel theme directory.

Returns:
the directory of the theme

Definition at line 222 of file kicontheme.h.

Referenced by iconPath(), KIconTheme(), list(), queryIcons(), and queryIconsByContext().

QStringList KIconTheme::inherits   const [inline]
 

The themes this icon theme falls back on.

Returns:
a list of icon themes that are used as fall-backs

Definition at line 228 of file kicontheme.h.

bool KIconTheme::isValid  
 

The icon theme exists?

Returns:
true if the icon theme is valid

Definition at line 205 of file kicontheme.cpp.

References QPtrList< KIconThemeDir >::isEmpty().

bool KIconTheme::isHidden  
 

The icon theme should be hidden to the user?

Returns:
true if the icon theme is hidden
Since:
3.1

Definition at line 210 of file kicontheme.cpp.

int KIconTheme::depth   const [inline]
 

The minimum display depth required for this theme.

This can either be 8 or 32.

Returns:
the minimum bpp (8 or 32)

Definition at line 248 of file kicontheme.h.

int KIconTheme::defaultSize KIcon::Group    group const
 

The default size of this theme for a certain icon group.

Parameters:
group  The icon group. See KIcon::Group.
Returns:
The default size in pixels for the given icon group.

Definition at line 222 of file kicontheme.cpp.

References KIcon::Group.

QValueList< int > KIconTheme::querySizes KIcon::Group    group const
 

Query available sizes for a group.

Parameters:
group  The icon group. See KIcon::Group.
Returns:
a list of available sized for the given group

Definition at line 232 of file kicontheme.cpp.

References KIcon::Group.

QStringList KIconTheme::queryIcons int    size,
KIcon::Context    context = KIcon::Any
const
 

Query available icons for a size and context.

Parameters:
size  the size of the icons
context  the context of the icons
Returns:
the list of icon names

Definition at line 243 of file kicontheme.cpp.

References KIcon::Any, KIcon::Context, QPtrListIterator::current(), dir(), KIcon::Fixed, KIcon::Scalable, KIcon::Threshold, and QPtrListIterator::toFirst().

QStringList KIconTheme::queryIconsByContext int    size,
KIcon::Context    context = KIcon::Any
const
 

Query available icons for a context and preferred size.

Parameters:
size  the size of the icons
context  the context of the icons
Returns:
the list of icon names

Definition at line 296 of file kicontheme.cpp.

References KIcon::Any, KIcon::Context, QPtrListIterator::current(), and dir().

KIcon KIconTheme::iconPath const QString   name,
int    size,
KIcon::MatchType    match
const
 

Lookup an icon in the theme.

Parameters:
name  The name of the icon, without extension.
size  The desired size of the icon.
match  The matching mode. KIcon::MatchExact returns an icon only if matches exactly. KIcon::MatchBest returns the best matching icon.
Returns:
A KIcon class that describes the icon. If an icon is found,
See also:
KIcon::isValid will return true, and false otherwise.

Definition at line 324 of file kicontheme.cpp.

References KIcon::context, QPtrListIterator::current(), dir(), KIcon::Fixed, QString::isEmpty(), KIcon::MatchExact, KIcon::MatchType, KIcon::path, KIcon::Scalable, KIcon::size, KIcon::threshold, KIcon::Threshold, and KIcon::type.

QStringList KIconTheme::list   [static]
 

List all icon themes installed on the system, global and local.

Returns:
the list of all icon themes

Definition at line 429 of file kicontheme.cpp.

References dir(), KGlobal::dirs(), QDir::entryList(), KStandardDirs::exists(), QDir::exists(), and KStandardDirs::resourceDirs().

QString KIconTheme::current   [static]
 

Returns the current icon theme.

Returns:
the name of the current theme

Definition at line 407 of file kicontheme.cpp.

References KGlobal::config(), defaultThemeName(), QString::fromLatin1(), and KConfigBase::readEntry().

void KIconTheme::reconfigure   [static]
 

Reconfigure the theme.

Definition at line 459 of file kicontheme.cpp.

Referenced by KInstance::newIconLoader().

QString KIconTheme::defaultThemeName   [static]
 

Returns the default icon theme.

Returns:
the name of the default theme name
Since:
3.1

Definition at line 468 of file kicontheme.cpp.

References QString::fromLatin1().

Referenced by current().


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:20:45 2003 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2001