Package: gtk

Function gtk-icon-theme-search-path

Lambda List

gtk-icon-theme-search-path (theme)

Syntax

(gtk-icon-theme-search-path theme) => path
(setf (gtk-icon-theme-search-path theme) path)

Arguments

theme -- a gtk-icon-theme object
path -- a list of strings with directories that are searched for icon themes

Details

Accessor of the icon theme path directories.

The gtk-icon-theme-search-path function gets the current list of strings with the search path that are searched for icon themes. The (setf gtk-icon-theme-search-path) function sets the search path.

When looking for an icon theme, GTK will search for a subdirectory of one or more of the directories in path with the same name as the icon theme. Icon themes from multiple of the path elements are combined to allow themes to be extended by adding icons in the home directory of the user.

In addition if an icon found is not found either in the current icon theme or the default icon theme, and an image file with the right name is found directly in one of the elements of path, then that image will be used for the icon name. This is legacy feature, and new icons should be put into the fallback icon theme, which is called Hicolor, rather than directly on the icon path.

Examples

(gtk-icon-theme-default) => #<GTK-ICON-THEME {1001A1A1A3}>
(gtk-icon-theme-search-path *)
=> ("/home/dieter/.local/share/icons" "/home/dieter/.icons"
    "/usr/share/ubuntu/icons" "/usr/local/share/icons"
    "/usr/share/icons" "/var/lib/snapd/desktop/icons"
    "/var/lib/snapd/desktop/icons" "/usr/share/ubuntu/pixmaps"
    "/usr/local/share/pixmaps" "/usr/share/pixmaps"
    "/var/lib/snapd/desktop/pixmaps" "/var/lib/snapd/desktop/pixmaps")    
 

See also

2021-11-28