IconFactory Class Reference

Icon theme manipulator and provider. More...

#include <iconfactory.h>

Collaboration diagram for IconFactory:

Public Member Functions
QIcon	fromTheme (const QString &name)
	Returns icon from active theme. More...
void	setupSearchPaths ()
	Adds custom application path to be search for icons.
QStringList	installedIconThemes () const
	Access to list of icon themes. More...
void	loadCurrentIconTheme ()
	Loads name of selected icon theme (from settings) for the application and activates it. More...
QString	currentIconTheme () const
	Gets name of current theme. More...
void	setCurrentIconTheme (const QString &theme_name)
	Sets icon theme with given name as the active one and loads it. More...

Static Public Member Functions
static IconFactory *	instance ()
	Singleton getter. More...

Detailed Description

Icon theme manipulator and provider.

Definition at line 47 of file iconfactory.h.

Member Function Documentation

QString IconFactory::currentIconTheme ( ) const

inline

Gets name of current theme.

Returns

Returns name of currently activated theme for the application.

Definition at line 87 of file iconfactory.h.

                                            {
      return m_currentIconTheme;
    }

QIcon IconFactory::fromTheme ( const QString &  name )

inline

Returns icon from active theme.

Parameters

name	Name of the icon.

Returns

Returns icon from active theme or invalid icon if "no icon theme" is set.

Definition at line 58 of file iconfactory.h.

                                                {
      if (m_currentIconTheme == APP_NO_THEME) {
        return QIcon();
      }

      if (!m_cachedIcons.contains(name)) {
        // Icon is not cached yet.
        m_cachedIcons.insert(name, QIcon(APP_THEME_PATH + QDir::separator() +
                                         m_currentIconTheme + QDir::separator() +
                                         name + APP_THEME_SUFFIX));
      }

      return m_cachedIcons.value(name);
    }

QStringList IconFactory::installedIconThemes

(

)

const

Access to list of icon themes.

Returns

Returns list of installed themes, including "default" theme.

Definition at line 101 of file iconfactory.cpp.

                                                   {
  QStringList icon_theme_names;
  icon_theme_names << APP_NO_THEME;

  // Iterate all directories with icon themes.
  QStringList icon_themes_paths = QIcon::themeSearchPaths();
  icon_themes_paths.removeDuplicates();

  foreach (const QString &icon_path, icon_themes_paths) {
    QDir icon_dir(icon_path);

    // Iterate all icon themes in this directory.
    foreach (const QString &icon_theme_path, icon_dir.entryList(QDir::Dirs | QDir::NoDotAndDotDot |
                                                                QDir::Readable | QDir::CaseSensitive |
                                                                QDir::NoSymLinks,
                                                                QDir::Time)) {
      icon_theme_names << icon_theme_path;
    }
  }

  icon_theme_names.removeDuplicates();
  return icon_theme_names;
}

Here is the caller graph for this function:

IconFactory * IconFactory::instance ( )

static

Singleton getter.

Returns

Returns pointer to singleton.

Definition at line 48 of file iconfactory.cpp.

                                   {
  if (s_instance.isNull()) {
    s_instance = new IconFactory(qApp);
  }

  return s_instance;
}

Here is the caller graph for this function:

void IconFactory::loadCurrentIconTheme

(

)

Loads name of selected icon theme (from settings) for the application and activates it.

Note

If that particular theme is not installed, then "default" theme is loaded.

Definition at line 69 of file iconfactory.cpp.

                                       {
  QStringList installed_themes = installedIconThemes();
  QString theme_name_from_settings = qApp->settings()->value(APP_CFG_GUI,
                                                             "icon_theme",
                                                             APP_THEME_DEFAULT).toString();

  if (m_currentIconTheme == theme_name_from_settings) {
    qDebug("Icon theme '%s' already loaded.",
           qPrintable(theme_name_from_settings));
    return;
  }

  // Display list of installed themes.
  qDebug("Installed icon themes are: %s.",
         qPrintable(QStringList(installed_themes).replaceInStrings(QRegExp("^|$"),
                                                                   "\'").join(", ")));

  if (installed_themes.contains(theme_name_from_settings)) {
    // Desired icon theme is installed and can be loaded.
    qDebug("Loading icon theme '%s'.", qPrintable(theme_name_from_settings));
    m_currentIconTheme = theme_name_from_settings;
  }
  else {
    // Desired icon theme is not currently available.
    // Install "default" icon theme instead.
    qDebug("Icon theme '%s' cannot be loaded because it is not installed. "
           "No icon theme is loaded now.",
           qPrintable(theme_name_from_settings));
    m_currentIconTheme = APP_NO_THEME;
  }
}

Here is the call graph for this function:

void IconFactory::setCurrentIconTheme

(

const QString &

theme_name

)

Sets icon theme with given name as the active one and loads it.

Parameters

theme_name

New theme name.

Definition at line 65 of file iconfactory.cpp.

                                                               {
  qApp->settings()->setValue(APP_CFG_GUI, "icon_theme", theme_name);
}

---

The documentation for this class was generated from the following files:

• iconfactory.h
• iconfactory.cpp