---
name: "Gtk2::IconTheme"
section: "3pm"
platform: "linux"
package: "libgtk2-perl-doc"
version: "2:1.24992-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Gtk2::IconTheme"
---

# Gtk2::IconTheme(3pm)

wrapper for GtkIconTheme

## NAME

Gtk2::IconTheme - wrapper for GtkIconTheme

## HIERARCHY

```
  Glib::Object
  +----Gtk2::IconTheme
```

## METHODS

### icontheme = Gtk2::IconTheme-\>new

### Gtk2::IconTheme-\>add\_builtin\_icon ($icon\_name, $size, $pixbuf)

- •

  `$icon_name` (string)

- •

  `$size` (integer)

- •

  `$pixbuf` (Gtk2::Gdk::Pixbuf)

### $icon\_theme-\>append\_search\_path ($path)

- •

  `$path` (localized file name)

### iconinfo or undef = $icon\_theme-\>choose\_icon ($icon\_names, $size, $flags)

- •

  `$icon_names` (scalar)

- •

  `$size` (integer)

- •

  `$flags` (Gtk2::IconLookupFlags)

Since: gtk+ 2.12

### $icon\_theme-\>set\_custom\_theme ($theme\_name)

- •

  `$theme_name` (string or undef)

Cannot be used on a `"Gtk2::IconTheme"` returned by Gtk2::IconTheme-\>get\_default or Gtk2::IconTheme-\>get\_for\_screen.

### icontheme = Gtk2::IconTheme-\>get\_default

### string or undef = $icon\_theme-\>get\_example\_icon\_name

### icontheme = Gtk2::IconTheme-\>get\_for\_screen ($screen)

- •

  `$screen` (Gtk2::Gdk::Screen)

### boolean = $icon\_theme-\>has\_icon ($icon\_name)

- •

  `$icon_name` (string)

### list = $icon\_theme-\>get\_icon\_sizes ($icon\_name)

- •

  `$icon_name` (string)

Since: gtk+ 2.6

### list = $icon\_theme-\>list\_contexts

Since: gtk+ 2.12

### list = $icon\_theme-\>list\_icons ($context)

- •

  `$context` (string or undef)

### pixbuf or undef = $icon\_theme-\>load\_icon ($icon\_name, $size, $flags)

- •

  `$icon_name` (string)

- •

  `$size` (integer)

- •

  `$flags` (Gtk2::IconLookupFlags)

May croak with a Glib::Error in $@ on failure.

### iconinfo or undef = $icon\_theme-\>lookup\_icon ($icon\_name, $size, $flags)

- •

  `$icon_name` (string)

- •

  `$size` (integer)

- •

  `$flags` (Gtk2::IconLookupFlags)

### $icon\_theme-\>prepend\_search\_path ($path)

- •

  `$path` (localized file name)

### boolean = $icon\_theme-\>rescan\_if\_needed

### $icon\_theme-\>set\_screen ($screen)

- •

  `$screen` (Gtk2::Gdk::Screen)

### list = $icon\_theme-\>get\_search\_path

### $icon\_theme-\>set\_search\_path (...)

- •

  ... (list)

## SIGNALS

- **changed** (Gtk2::IconTheme)

  ## ENUMS AND FLAGS

### flags Gtk2::IconLookupFlags

- •

  'no-svg' / 'GTK\_ICON\_LOOKUP\_NO\_SVG'

- •

  'force-svg' / 'GTK\_ICON\_LOOKUP\_FORCE\_SVG'

- •

  'use-builtin' / 'GTK\_ICON\_LOOKUP\_USE\_BUILTIN'

- •

  'generic-fallback' / 'GTK\_ICON\_LOOKUP\_GENERIC\_FALLBACK'

- •

  'force-size' / 'GTK\_ICON\_LOOKUP\_FORCE\_SIZE'

### enum Gtk2::IconThemeError

- •

  'not-found' / 'GTK\_ICON\_THEME\_NOT\_FOUND'

- •

  'failed' / 'GTK\_ICON\_THEME\_FAILED'

## SEE ALSO

Gtk2, Glib::Object

## COPYRIGHT

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL.  See Gtk2 for a full notice.