KDE 4.7 PyKDE API Reference

- KDE's Python API

# KIconTheme Class Reference

`from PyKDE4.kdeui import *`

## Detailed Description

Internal:
  Class to use/access icon themes in KDE. This class is used by the iconloader but can be used by others too.

Warning:
  You should not use this class externally. This class is exported because the KCM needs it.

See also:
  KIconLoader

## Enumerations

ContextMenus | { TextEditor, ReadOnlyText }

## Methods

| __init__ (self, KIconTheme other)
| __init__ (self, QString name, QString appName=QString())
int | depth (self)
QString | description (self)
QString | dir (self)
QString | example (self)
QStringList | inherits (self)
QString | internalName (self)
bool | isHidden (self)
bool | isValid (self)
QString | name (self)
QString | screenshot (self)

## Static Methods

| assignIconsToContextMenu (KIconTheme.ContextMenus type, [QAction] actions)
QString | current ()
QString | defaultThemeName ()
QStringList | list ()
| reconfigure ()

## Method Documentation

__init__ | ( | self, |
|  | KIconTheme | other
| ) |  |  |

__init__ | ( | self, |
|  | QString | name,
|  | QString | appName=QString()
| ) |  |  |

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.

int depth | ( |  | self ) |

The minimum display depth required for this theme. This can either be 8 or 32.

Returns:
  the minimum bpp (8 or 32)

QString description | ( |  | self ) |

A description for the icon theme.

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

QString dir | ( |  | self ) |

Returns the toplevel theme directory.

Returns:
  the directory of the theme

QString example | ( |  | self ) |

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() if there is none

QStringList inherits | ( |  | self ) |

The themes this icon theme falls back on.

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

QString internalName | ( |  | self ) |

The internal name of the icon theme (same as the name argument passed to the constructor).

Returns:
  the internal name of the theme

bool isHidden | ( |  | self ) |

The icon theme should be hidden to the user?

Returns:
  true if the icon theme is hidden

bool isValid | ( |  | self ) |

The icon theme exists?

Returns:
  true if the icon theme is valid

QString name | ( |  | self ) |

The stylized name of the icon theme.

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

QString screenshot | ( |  | self ) |

Return the name of the screenshot.

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

## Static Method Documentation

assignIconsToContextMenu | ( | KIconTheme.ContextMenus | type,
|  | [QAction] | actions
| ) |  |  |

Assigns standard icons to the various standard text edit context menus.

QString current | ( |  | ) |

Returns the current icon theme.

Returns:
  the name of the current theme

QString defaultThemeName | ( |  | ) |

Returns the default icon theme.

Returns:
  the name of the default theme name

QStringList list | ( |  | ) |

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

Returns:
  the list of all icon themes

reconfigure | ( |  | ) |

Reconfigure the theme.

## Enumeration Documentation

ContextMenus

Defines the context menus that assignIconsToContextMenus is aware of.

For ReadOnlyText the menu is expected to have one entry.

TextEditor is expected to have the full complement of undo, redo, cut, copy, paste and clear.

Enumerator:

  TextEditor |
  ReadOnlyText |