diff options
Diffstat (limited to 'gtk+-mingw/share/gtk-doc/html/gtk3/GtkIconTheme.html')
| -rw-r--r-- | gtk+-mingw/share/gtk-doc/html/gtk3/GtkIconTheme.html | 1644 |
1 files changed, 0 insertions, 1644 deletions
diff --git a/gtk+-mingw/share/gtk-doc/html/gtk3/GtkIconTheme.html b/gtk+-mingw/share/gtk-doc/html/gtk3/GtkIconTheme.html deleted file mode 100644 index 7b90fc3..0000000 --- a/gtk+-mingw/share/gtk-doc/html/gtk3/GtkIconTheme.html +++ /dev/null @@ -1,1644 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>GtkIconTheme</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> -<link rel="home" href="index.html" title="GTK+ 3 Reference Manual"> -<link rel="up" href="theming.html" title="Part III. Theming in GTK+"> -<link rel="prev" href="gtk3-GtkGradient.html" title="GtkGradient"> -<link rel="next" href="gtk3-Themeable-Stock-Images.html" title="Themeable Stock Images"> -<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)"> -<link rel="stylesheet" href="style.css" type="text/css"> -</head> -<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> -<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> -<tr valign="middle"> -<td><a accesskey="p" href="gtk3-GtkGradient.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> -<td><a accesskey="u" href="theming.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> -<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> -<th width="100%" align="center">GTK+ 3 Reference Manual</th> -<td><a accesskey="n" href="gtk3-Themeable-Stock-Images.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> -</tr> -<tr><td colspan="5" class="shortcuts"> -<a href="#GtkIconTheme.synopsis" class="shortcut">Top</a> - | - <a href="#GtkIconTheme.description" class="shortcut">Description</a> - | - <a href="#GtkIconTheme.object-hierarchy" class="shortcut">Object Hierarchy</a> - | - <a href="#GtkIconTheme.signals" class="shortcut">Signals</a> -</td></tr> -</table> -<div class="refentry"> -<a name="GtkIconTheme"></a><div class="titlepage"></div> -<div class="refnamediv"><table width="100%"><tr> -<td valign="top"> -<h2><span class="refentrytitle"><a name="GtkIconTheme.top_of_page"></a>GtkIconTheme</span></h2> -<p>GtkIconTheme — Looking up icons by name</p> -</td> -<td valign="top" align="right"></td> -</tr></table></div> -<div class="refsynopsisdiv"> -<a name="GtkIconTheme.synopsis"></a><h2>Synopsis</h2> -<pre class="synopsis"> -#include <gtk/gtk.h> - - <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a>; -struct <a class="link" href="GtkIconTheme.html#GtkIconTheme-struct" title="struct GtkIconTheme">GtkIconTheme</a>; -enum <a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags">GtkIconLookupFlags</a>; -#define <a class="link" href="GtkIconTheme.html#GTK-ICON-THEME-ERROR:CAPS" title="GTK_ICON_THEME_ERROR">GTK_ICON_THEME_ERROR</a> -enum <a class="link" href="GtkIconTheme.html#GtkIconThemeError" title="enum GtkIconThemeError">GtkIconThemeError</a>; -<a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="returnvalue">GtkIconTheme</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-new" title="gtk_icon_theme_new ()">gtk_icon_theme_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="returnvalue">GtkIconTheme</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-default" title="gtk_icon_theme_get_default ()">gtk_icon_theme_get_default</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="returnvalue">GtkIconTheme</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-for-screen" title="gtk_icon_theme_get_for_screen ()">gtk_icon_theme_get_for_screen</a> (<em class="parameter"><code><a href="http://developer.gnome.org/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-screen" title="gtk_icon_theme_set_screen ()">gtk_icon_theme_set_screen</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-search-path" title="gtk_icon_theme_set_search_path ()">gtk_icon_theme_set_search_path</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path[]</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_elements</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-search-path" title="gtk_icon_theme_get_search_path ()">gtk_icon_theme_get_search_path</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **path[]</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_elements</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-append-search-path" title="gtk_icon_theme_append_search_path ()">gtk_icon_theme_append_search_path</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-prepend-search-path" title="gtk_icon_theme_prepend_search_path ()">gtk_icon_theme_prepend_search_path</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-custom-theme" title="gtk_icon_theme_set_custom_theme ()">gtk_icon_theme_set_custom_theme</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *theme_name</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-has-icon" title="gtk_icon_theme_has_icon ()">gtk_icon_theme_has_icon</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>); -<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()">gtk_icon_theme_lookup_icon</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags"><span class="type">GtkIconLookupFlags</span></a> flags</code></em>); -<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-choose-icon" title="gtk_icon_theme_choose_icon ()">gtk_icon_theme_choose_icon</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_names[]</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags"><span class="type">GtkIconLookupFlags</span></a> flags</code></em>); -<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-by-gicon" title="gtk_icon_theme_lookup_by_gicon ()">gtk_icon_theme_lookup_by_gicon</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *icon</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags"><span class="type">GtkIconLookupFlags</span></a> flags</code></em>); -<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-load-icon" title="gtk_icon_theme_load_icon ()">gtk_icon_theme_load_icon</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags"><span class="type">GtkIconLookupFlags</span></a> flags</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-list-contexts" title="gtk_icon_theme_list_contexts ()">gtk_icon_theme_list_contexts</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-list-icons" title="gtk_icon_theme_list_icons ()">gtk_icon_theme_list_icons</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *context</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-icon-sizes" title="gtk_icon_theme_get_icon_sizes ()">gtk_icon_theme_get_icon_sizes</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>); -<span class="returnvalue">char</span> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-example-icon-name" title="gtk_icon_theme_get_example_icon_name ()">gtk_icon_theme_get_example_icon_name</a> - (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-rescan-if-needed" title="gtk_icon_theme_rescan_if_needed ()">gtk_icon_theme_rescan_if_needed</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-add-builtin-icon" title="gtk_icon_theme_add_builtin_icon ()">gtk_icon_theme_add_builtin_icon</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); -<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-copy" title="gtk_icon_info_copy ()">gtk_icon_info_copy</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkIconTheme.html#gtk-icon-info-free" title="gtk_icon_info_free ()">gtk_icon_info_free</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>); -<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-new-for-pixbuf" title="gtk_icon_info_new_for_pixbuf ()">gtk_icon_info_new_for_pixbuf</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-base-size" title="gtk_icon_info_get_base_size ()">gtk_icon_info_get_base_size</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-filename" title="gtk_icon_info_get_filename ()">gtk_icon_info_get_filename</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>); -<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-builtin-pixbuf" title="gtk_icon_info_get_builtin_pixbuf ()">gtk_icon_info_get_builtin_pixbuf</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>); -<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()">gtk_icon_info_load_icon</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); -<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-symbolic" title="gtk_icon_info_load_symbolic ()">gtk_icon_info_load_symbolic</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *fg</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *success_color</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *warning_color</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *error_color</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *was_symbolic</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); -<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-symbolic-for-style" title="gtk_icon_info_load_symbolic_for_style ()">gtk_icon_info_load_symbolic_for_style</a> - (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> *style</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *was_symbolic</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); -<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-symbolic-for-context" title="gtk_icon_info_load_symbolic_for_context ()">gtk_icon_info_load_symbolic_for_context</a> - (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *was_symbolic</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkIconTheme.html#gtk-icon-info-set-raw-coordinates" title="gtk_icon_info_set_raw_coordinates ()">gtk_icon_info_set_raw_coordinates</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> raw_coordinates</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-embedded-rect" title="gtk_icon_info_get_embedded_rect ()">gtk_icon_info_get_embedded_rect</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rectangle</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-attach-points" title="gtk_icon_info_get_attach_points ()">gtk_icon_info_get_attach_points</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkPoint"><span class="type">GdkPoint</span></a> **points</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_points</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-display-name" title="gtk_icon_info_get_display_name ()">gtk_icon_info_get_display_name</a> (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>); -</pre> -</div> -<div class="refsect1"> -<a name="GtkIconTheme.object-hierarchy"></a><h2>Object Hierarchy</h2> -<pre class="synopsis"> - <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> - +----GtkIconTheme -</pre> -</div> -<div class="refsect1"> -<a name="GtkIconTheme.signals"></a><h2>Signals</h2> -<pre class="synopsis"> - "<a class="link" href="GtkIconTheme.html#GtkIconTheme-changed" title='The "changed" signal'>changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> -</pre> -</div> -<div class="refsect1"> -<a name="GtkIconTheme.description"></a><h2>Description</h2> -<p> -<a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> provides a facility for looking up icons by name -and size. The main reason for using a name rather than simply -providing a filename is to allow different icons to be used -depending on what <em class="firstterm">icon theme</em> is selected -by the user. The operation of icon themes on Linux and Unix -follows the <a class="ulink" href="http://www.freedesktop.org/Standards/icon-theme-spec" target="_top">Icon -Theme Specification</a>. There is a default icon theme, -named <code class="literal">hicolor</code> where applications should install -their icons, but more additional application themes can be -installed as operating system vendors and users choose. -</p> -<p> -Named icons are similar to the <a class="xref" href="gtk3-Themeable-Stock-Images.html" title="Themeable Stock Images"><span class="refentrytitle"><a name="gtk3-Themeable-Stock-Images.top_of_page"></a>Themeable Stock Images</span>(3)</a> -facility, and the distinction between the two may be a bit confusing. -A few things to keep in mind: -</p> -<div class="itemizedlist"><ul class="itemizedlist" type="disc"> -<li class="listitem"> -Stock images usually are used in conjunction with -<a class="xref" href="gtk3-Stock-Items.html" title="Stock Items"><span class="refentrytitle"><a name="gtk3-Stock-Items.top_of_page"></a>Stock Items</span>(3)</a>, such as <a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-OK:CAPS" title="GTK_STOCK_OK"><code class="literal">GTK_STOCK_OK</code></a> or -<a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-OPEN:CAPS" title="GTK_STOCK_OPEN"><code class="literal">GTK_STOCK_OPEN</code></a>. Named icons are easier to set up and therefore -are more useful for new icons that an application wants to -add, such as application icons or window icons. -</li> -<li class="listitem"> -Stock images can only be loaded at the symbolic sizes defined -by the <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> enumeration, or by custom sizes defined -by <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-register" title="gtk_icon_size_register ()"><code class="function">gtk_icon_size_register()</code></a>, while named icons are more flexible -and any pixel size can be specified. -</li> -<li class="listitem"> -Because stock images are closely tied to stock items, and thus -to actions in the user interface, stock images may come in -multiple variants for different widget states or writing -directions. -</li> -</ul></div> -<p> -A good rule of thumb is that if there is a stock image for what -you want to use, use it, otherwise use a named icon. It turns -out that internally stock images are generally defined in -terms of one or more named icons. (An example of the -more than one case is icons that depend on writing direction; -<a class="link" href="gtk3-Stock-Items.html#GTK-STOCK-GO-FORWARD:CAPS" title="GTK_STOCK_GO_FORWARD"><code class="literal">GTK_STOCK_GO_FORWARD</code></a> uses the two themed icons -"gtk-stock-go-forward-ltr" and "gtk-stock-go-forward-rtl".) -</p> -<p> -In many cases, named themes are used indirectly, via <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> -or stock items, rather than directly, but looking up icons -directly is also simple. The <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> object acts -as a database of all the icons in the current theme. You -can create new <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> objects, but its much more -efficient to use the standard icon theme for the <a href="http://developer.gnome.org/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> -so that the icon information is shared with other people -looking up icons. In the case where the default screen is -being used, looking up an icon can be as simple as: -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span> -<span class="usertype">GtkIconTheme</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">icon_theme</span><span class="symbol">;</span> -<span class="usertype">GdkPixbuf</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">pixbuf</span><span class="symbol">;</span> - -<span class="normal">icon_theme </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkIconTheme.html#gtk-icon-theme-get-default">gtk_icon_theme_get_default</a></span><span class="normal"> </span><span class="symbol">();</span> -<span class="normal">pixbuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkIconTheme.html#gtk-icon-theme-load-icon">gtk_icon_theme_load_icon</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">icon_theme</span><span class="symbol">,</span> -<span class="normal"> </span><span class="string">"my-icon-name"</span><span class="symbol">,</span><span class="normal"> </span><span class="comment">// icon name</span> -<span class="normal"> </span><span class="number">48</span><span class="symbol">,</span><span class="normal"> </span><span class="comment">// size</span> -<span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="comment">// flags</span> -<span class="normal"> </span><span class="symbol">&</span><span class="normal">error</span><span class="symbol">);</span> -<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">pixbuf</span><span class="symbol">)</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-warning">g_warning</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Couldn't load icon: %s"</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">-></span><span class="normal">message</span><span class="symbol">);</span> -<span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">);</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="keyword">else</span> -<span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="comment">// Use the pixbuf</span> -<span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">);</span> -<span class="normal"> </span><span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -</div> -<div class="refsect1"> -<a name="GtkIconTheme.details"></a><h2>Details</h2> -<div class="refsect2"> -<a name="GtkIconInfo"></a><h3>GtkIconInfo</h3> -<pre class="programlisting">typedef struct _GtkIconInfo GtkIconInfo;</pre> -<p> -Contains information found when looking up an icon in -an icon theme. -</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkIconTheme-struct"></a><h3>struct GtkIconTheme</h3> -<pre class="programlisting">struct GtkIconTheme;</pre> -<p> -Acts as a database of information about an icon theme. -Normally, you retrieve the icon theme for a particular -screen using <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-for-screen" title="gtk_icon_theme_get_for_screen ()"><code class="function">gtk_icon_theme_get_for_screen()</code></a> and it -will contain information about current icon theme for -that screen, but you can also create a new <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -object and set the icon theme name explicitely using -<a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-custom-theme" title="gtk_icon_theme_set_custom_theme ()"><code class="function">gtk_icon_theme_set_custom_theme()</code></a>. -</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkIconLookupFlags"></a><h3>enum GtkIconLookupFlags</h3> -<pre class="programlisting">typedef enum { - GTK_ICON_LOOKUP_NO_SVG = 1 << 0, - GTK_ICON_LOOKUP_FORCE_SVG = 1 << 1, - GTK_ICON_LOOKUP_USE_BUILTIN = 1 << 2, - GTK_ICON_LOOKUP_GENERIC_FALLBACK = 1 << 3, - GTK_ICON_LOOKUP_FORCE_SIZE = 1 << 4 -} GtkIconLookupFlags; -</pre> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GTK-ICON-LOOKUP-NO-SVG:CAPS"></a><span class="term"><code class="literal">GTK_ICON_LOOKUP_NO_SVG</code></span></p></td> -<td>Never return SVG icons, even if gdk-pixbuf - supports them. Cannot be used together with <a class="link" href="GtkIconTheme.html#GTK-ICON-LOOKUP-FORCE-SVG:CAPS"><code class="literal">GTK_ICON_LOOKUP_FORCE_SVG</code></a>. -</td> -</tr> -<tr> -<td><p><a name="GTK-ICON-LOOKUP-FORCE-SVG:CAPS"></a><span class="term"><code class="literal">GTK_ICON_LOOKUP_FORCE_SVG</code></span></p></td> -<td>Return SVG icons, even if gdk-pixbuf - doesn't support them. - Cannot be used together with <a class="link" href="GtkIconTheme.html#GTK-ICON-LOOKUP-NO-SVG:CAPS"><code class="literal">GTK_ICON_LOOKUP_NO_SVG</code></a>. -</td> -</tr> -<tr> -<td><p><a name="GTK-ICON-LOOKUP-USE-BUILTIN:CAPS"></a><span class="term"><code class="literal">GTK_ICON_LOOKUP_USE_BUILTIN</code></span></p></td> -<td>When passed to - <a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a> includes builtin icons - as well as files. For a builtin icon, <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-filename" title="gtk_icon_info_get_filename ()"><code class="function">gtk_icon_info_get_filename()</code></a> -</td> -</tr> -<tr> -<td><p><a name="GTK-ICON-LOOKUP-GENERIC-FALLBACK:CAPS"></a><span class="term"><code class="literal">GTK_ICON_LOOKUP_GENERIC_FALLBACK</code></span></p></td> -<td></td> -</tr> -<tr> -<td><p><a name="GTK-ICON-LOOKUP-FORCE-SIZE:CAPS"></a><span class="term"><code class="literal">GTK_ICON_LOOKUP_FORCE_SIZE</code></span></p></td> -<td></td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GTK-ICON-THEME-ERROR:CAPS"></a><h3>GTK_ICON_THEME_ERROR</h3> -<pre class="programlisting">#define GTK_ICON_THEME_ERROR gtk_icon_theme_error_quark () -</pre> -<p> -The <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> used for <a class="link" href="GtkIconTheme.html#GtkIconThemeError" title="enum GtkIconThemeError"><span class="type">GtkIconThemeError</span></a> errors. -</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkIconThemeError"></a><h3>enum GtkIconThemeError</h3> -<pre class="programlisting">typedef enum { - GTK_ICON_THEME_NOT_FOUND, - GTK_ICON_THEME_FAILED -} GtkIconThemeError; -</pre> -<p> -Error codes for GtkIconTheme operations. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GTK-ICON-THEME-NOT-FOUND:CAPS"></a><span class="term"><code class="literal">GTK_ICON_THEME_NOT_FOUND</code></span></p></td> -<td>The icon specified does not exist in the theme -</td> -</tr> -<tr> -<td><p><a name="GTK-ICON-THEME-FAILED:CAPS"></a><span class="term"><code class="literal">GTK_ICON_THEME_FAILED</code></span></p></td> -<td>An unspecified error occurred. -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-new"></a><h3>gtk_icon_theme_new ()</h3> -<pre class="programlisting"><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="returnvalue">GtkIconTheme</span></a> * gtk_icon_theme_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<p> -Creates a new icon theme object. Icon theme objects are used -to lookup up an icon by name in a particular icon theme. -Usually, you'll want to use <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-default" title="gtk_icon_theme_get_default ()"><code class="function">gtk_icon_theme_get_default()</code></a> -or <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-for-screen" title="gtk_icon_theme_get_for_screen ()"><code class="function">gtk_icon_theme_get_for_screen()</code></a> rather than creating -a new icon theme object for scratch. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the newly created <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> object.</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-get-default"></a><h3>gtk_icon_theme_get_default ()</h3> -<pre class="programlisting"><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="returnvalue">GtkIconTheme</span></a> * gtk_icon_theme_get_default (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<p> -Gets the icon theme for the default screen. See -<a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-for-screen" title="gtk_icon_theme_get_for_screen ()"><code class="function">gtk_icon_theme_get_for_screen()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>A unique <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> associated with -the default screen. This icon theme is associated with -the screen and can be used as long as the screen -is open. Do not ref or unref it. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-get-for-screen"></a><h3>gtk_icon_theme_get_for_screen ()</h3> -<pre class="programlisting"><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="returnvalue">GtkIconTheme</span></a> * gtk_icon_theme_get_for_screen (<em class="parameter"><code><a href="http://developer.gnome.org/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre> -<p> -Gets the icon theme object associated with <em class="parameter"><code>screen</code></em>; if this -function has not previously been called for the given -screen, a new icon theme object will be created and -associated with the screen. Icon theme objects are -fairly expensive to create, so using this function -is usually a better choice than calling than <a class="link" href="GtkIconTheme.html#gtk-icon-theme-new" title="gtk_icon_theme_new ()"><code class="function">gtk_icon_theme_new()</code></a> -and setting the screen yourself; by using this function -a single icon theme object will be shared between users. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td> -<td>a <a href="http://developer.gnome.org/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>A unique <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> associated with -the given screen. This icon theme is associated with -the screen and can be used as long as the screen -is open. Do not ref or unref it. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-set-screen"></a><h3>gtk_icon_theme_set_screen ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_icon_theme_set_screen (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre> -<p> -Sets the screen for an icon theme; the screen is used -to track the user's currently configured icon theme, -which might be different for different screens. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td> -<td>a <a href="http://developer.gnome.org/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-set-search-path"></a><h3>gtk_icon_theme_set_search_path ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_icon_theme_set_search_path (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path[]</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_elements</code></em>);</pre> -<p> -Sets the search path for the icon theme object. When looking -for an icon theme, GTK+ will search for a subdirectory of -one or more of the directories in <em class="parameter"><code>path</code></em> with the same name -as the icon theme. (Themes from multiple of the path elements -are combined to allow themes to be extended by adding icons -in the user's home directory.) -</p> -<p> -In addition if an icon found isn't 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 -<em class="parameter"><code>path</code></em>, then that image will be used for the icon name. -(This is legacy feature, and new icons should be put -into the default icon theme, which is called DEFAULT_THEME_NAME, -rather than directly on the icon path.) -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> -<td>array of -directories that are searched for icon themes. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_elements][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>n_elements</code></em> :</span></p></td> -<td>number of elements in <em class="parameter"><code>path</code></em>.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-get-search-path"></a><h3>gtk_icon_theme_get_search_path ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_icon_theme_get_search_path (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **path[]</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_elements</code></em>);</pre> -<p> -Gets the current search path. See <a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-search-path" title="gtk_icon_theme_set_search_path ()"><code class="function">gtk_icon_theme_set_search_path()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> -<td>location to store a list of icon theme path directories or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. -The stored value should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_elements][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>n_elements</code></em> :</span></p></td> -<td>location to store number of elements in <em class="parameter"><code>path</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-append-search-path"></a><h3>gtk_icon_theme_append_search_path ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_icon_theme_append_search_path (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre> -<p> -Appends a directory to the search path. -See <a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-search-path" title="gtk_icon_theme_set_search_path ()"><code class="function">gtk_icon_theme_set_search_path()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> -<td>directory name to append to the icon path. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-prepend-search-path"></a><h3>gtk_icon_theme_prepend_search_path ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_icon_theme_prepend_search_path (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre> -<p> -Prepends a directory to the search path. -See <a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-search-path" title="gtk_icon_theme_set_search_path ()"><code class="function">gtk_icon_theme_set_search_path()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> -<td>directory name to prepend to the icon path. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-set-custom-theme"></a><h3>gtk_icon_theme_set_custom_theme ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_icon_theme_set_custom_theme (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *theme_name</code></em>);</pre> -<p> -Sets the name of the icon theme that the <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> object uses -overriding system configuration. This function cannot be called -on the icon theme objects returned from <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-default" title="gtk_icon_theme_get_default ()"><code class="function">gtk_icon_theme_get_default()</code></a> -and <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-for-screen" title="gtk_icon_theme_get_for_screen ()"><code class="function">gtk_icon_theme_get_for_screen()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>theme_name</code></em> :</span></p></td> -<td>name of icon theme to use instead of -configured theme, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset a previously set custom theme. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-has-icon"></a><h3>gtk_icon_theme_has_icon ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_icon_theme_has_icon (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre> -<p> -Checks whether an icon theme includes an icon -for a particular name. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td> -<td>the name of an icon</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>icon_theme</code></em> includes an -icon for <em class="parameter"><code>icon_name</code></em>.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-lookup-icon"></a><h3>gtk_icon_theme_lookup_icon ()</h3> -<pre class="programlisting"><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * gtk_icon_theme_lookup_icon (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags"><span class="type">GtkIconLookupFlags</span></a> flags</code></em>);</pre> -<p> -Looks up a named icon and returns a structure containing -information such as the filename of the icon. The icon -can then be rendered into a pixbuf using -<a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()"><code class="function">gtk_icon_info_load_icon()</code></a>. (<a class="link" href="GtkIconTheme.html#gtk-icon-theme-load-icon" title="gtk_icon_theme_load_icon ()"><code class="function">gtk_icon_theme_load_icon()</code></a> -combines these two steps if all you need is the pixbuf.) -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td> -<td>the name of the icon to lookup</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td> -<td>desired icon size</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>flags modifying the behavior of the icon lookup</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> structure containing information -about the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon wasn't found. Free with -<a class="link" href="GtkIconTheme.html#gtk-icon-info-free" title="gtk_icon_info_free ()"><code class="function">gtk_icon_info_free()</code></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-choose-icon"></a><h3>gtk_icon_theme_choose_icon ()</h3> -<pre class="programlisting"><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * gtk_icon_theme_choose_icon (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_names[]</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags"><span class="type">GtkIconLookupFlags</span></a> flags</code></em>);</pre> -<p> -Looks up a named icon and returns a structure containing -information such as the filename of the icon. The icon -can then be rendered into a pixbuf using -<a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()"><code class="function">gtk_icon_info_load_icon()</code></a>. (<a class="link" href="GtkIconTheme.html#gtk-icon-theme-load-icon" title="gtk_icon_theme_load_icon ()"><code class="function">gtk_icon_theme_load_icon()</code></a> -combines these two steps if all you need is the pixbuf.) -</p> -<p> -If <em class="parameter"><code>icon_names</code></em> contains more than one name, this function -tries them all in the given order before falling back to -inherited icon themes. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_names</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of -icon names to lookup. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td> -<td>desired icon size</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>flags modifying the behavior of the icon lookup</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> structure containing information -about the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon wasn't found. Free with -<a class="link" href="GtkIconTheme.html#gtk-icon-info-free" title="gtk_icon_info_free ()"><code class="function">gtk_icon_info_free()</code></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-lookup-by-gicon"></a><h3>gtk_icon_theme_lookup_by_gicon ()</h3> -<pre class="programlisting"><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * gtk_icon_theme_lookup_by_gicon (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *icon</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags"><span class="type">GtkIconLookupFlags</span></a> flags</code></em>);</pre> -<p> -Looks up an icon and returns a structure containing -information such as the filename of the icon. -The icon can then be rendered into a pixbuf using -<a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()"><code class="function">gtk_icon_info_load_icon()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> to look up</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td> -<td>desired icon size</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>flags modifying the behavior of the icon lookup</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> structure containing -information about the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon -wasn't found. Free with <a class="link" href="GtkIconTheme.html#gtk-icon-info-free" title="gtk_icon_info_free ()"><code class="function">gtk_icon_info_free()</code></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.14</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-load-icon"></a><h3>gtk_icon_theme_load_icon ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gtk_icon_theme_load_icon (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags"><span class="type">GtkIconLookupFlags</span></a> flags</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> -<p> -Looks up an icon in an icon theme, scales it to the given size -and renders it into a pixbuf. This is a convenience function; -if more details about the icon are needed, use -<a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a> followed by <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()"><code class="function">gtk_icon_info_load_icon()</code></a>. -</p> -<p> -Note that you probably want to listen for icon theme changes and -update the icon. This is usually done by connecting to the -GtkWidget::style-set signal. If for some reason you do not want to -update the icon when the icon theme changes, you should consider -using <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-copy"><code class="function">gdk_pixbuf_copy()</code></a> to make a private copy of the pixbuf -returned by this function. Otherwise GTK+ may need to keep the old -icon theme loaded, which would be a waste of memory. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td> -<td>the name of the icon to lookup</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td> -<td>the desired icon size. The resulting icon may not be -exactly this size; see <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()"><code class="function">gtk_icon_info_load_icon()</code></a>.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>flags modifying the behavior of the icon lookup</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> -<td>Location to store error information on failure, -or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the rendered icon; this may be a -newly created icon or a new reference to an internal icon, so -you must not modify the icon. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release -your reference to the icon. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon isn't found. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-list-contexts"></a><h3>gtk_icon_theme_list_contexts ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * gtk_icon_theme_list_contexts (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>);</pre> -<p> -Gets the list of contexts available within the current -hierarchy of icon themes -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> list -holding the names of all the contexts in the theme. You must first -free each element in the list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, then free the list -itself with <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-list-icons"></a><h3>gtk_icon_theme_list_icons ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * gtk_icon_theme_list_icons (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *context</code></em>);</pre> -<p> -Lists the icons in the current icon theme. Only a subset -of the icons can be listed by providing a context string. -The set of values for the context string is system dependent, -but will typically include such values as "Applications" and -"MimeTypes". -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>a string identifying a particular type of -icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to list all icons. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> list -holding the names of all the icons in the theme. You must first -free each element in the list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, then free the list -itself with <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-get-icon-sizes"></a><h3>gtk_icon_theme_get_icon_sizes ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> * gtk_icon_theme_get_icon_sizes (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre> -<p> -Returns an array of integers describing the sizes at which -the icon is available without scaling. A size of -1 means -that the icon is available in a scalable format. The array -is zero-terminated. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td> -<td>the name of an icon</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>An newly allocated array -describing the sizes at which the icon is available. The array -should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when it is no longer needed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-get-example-icon-name"></a><h3>gtk_icon_theme_get_example_icon_name ()</h3> -<pre class="programlisting"><span class="returnvalue">char</span> * gtk_icon_theme_get_example_icon_name - (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>);</pre> -<p> -Gets the name of an icon that is representative of the -current theme (for instance, to use when presenting -a list of themes to the user.) -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the name of an example icon or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. -Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-rescan-if-needed"></a><h3>gtk_icon_theme_rescan_if_needed ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_icon_theme_rescan_if_needed (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>);</pre> -<p> -Checks to see if the icon theme has changed; if it has, any -currently cached information is discarded and will be reloaded -next time <em class="parameter"><code>icon_theme</code></em> is accessed. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon theme has changed and needed -to be reloaded.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-theme-add-builtin-icon"></a><h3>gtk_icon_theme_add_builtin_icon ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_icon_theme_add_builtin_icon (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> -<p> -Registers a built-in icon for icon theme lookups. The idea -of built-in icons is to allow an application or library -that uses themed icons to function requiring files to -be present in the file system. For instance, the default -images for all of GTK+'s stock icons are registered -as built-icons. -</p> -<p> -In general, if you use <a class="link" href="GtkIconTheme.html#gtk-icon-theme-add-builtin-icon" title="gtk_icon_theme_add_builtin_icon ()"><code class="function">gtk_icon_theme_add_builtin_icon()</code></a> -you should also install the icon in the icon theme, so -that the icon is generally available. -</p> -<p> -This function will generally be used with pixbufs loaded -via <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline"><code class="function">gdk_pixbuf_new_from_inline()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td> -<td>the name of the icon to register</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td> -<td>the size at which to register the icon (different -images can be registered for the same icon name -at different sizes.)</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> that contains the image to use -for <em class="parameter"><code>icon_name</code></em>.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-copy"></a><h3>gtk_icon_info_copy ()</h3> -<pre class="programlisting"><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * gtk_icon_info_copy (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>);</pre> -<p> -Make a copy of a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the new GtkIconInfo</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-free"></a><h3>gtk_icon_info_free ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_icon_info_free (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>);</pre> -<p> -Free a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> and associated information -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-new-for-pixbuf"></a><h3>gtk_icon_info_new_for_pixbuf ()</h3> -<pre class="programlisting"><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="returnvalue">GtkIconInfo</span></a> * gtk_icon_info_new_for_pixbuf (<em class="parameter"><code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> -<p> -Creates a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> for a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> -<td>the pixbuf to wrap in a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.14</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-get-base-size"></a><h3>gtk_icon_info_get_base_size ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_icon_info_get_base_size (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>);</pre> -<p> -Gets the base size for the icon. The base size -is a size for the icon that was specified by -the icon theme creator. This may be different -than the actual size of image; an example of -this is small emblem icons that can be attached -to a larger icon. These icons will be given -the same base size as the larger icons to which -they are attached. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the base size, or 0, if no base -size is known for the icon.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-get-filename"></a><h3>gtk_icon_info_get_filename ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_icon_info_get_filename (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>);</pre> -<p> -Gets the filename for the icon. If the -<a class="link" href="GtkIconTheme.html#GTK-ICON-LOOKUP-USE-BUILTIN:CAPS"><code class="literal">GTK_ICON_LOOKUP_USE_BUILTIN</code></a> flag was passed -to <a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a>, there may be -no filename if a builtin icon is returned; in this -case, you should use <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-builtin-pixbuf" title="gtk_icon_info_get_builtin_pixbuf ()"><code class="function">gtk_icon_info_get_builtin_pixbuf()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the filename for the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -if <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-builtin-pixbuf" title="gtk_icon_info_get_builtin_pixbuf ()"><code class="function">gtk_icon_info_get_builtin_pixbuf()</code></a> should be used instead. The -return value is owned by GTK+ and should not be modified or freed. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-get-builtin-pixbuf"></a><h3>gtk_icon_info_get_builtin_pixbuf ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gtk_icon_info_get_builtin_pixbuf (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>);</pre> -<p> -Gets the built-in image for this icon, if any. To allow -GTK+ to use built in icon images, you must pass the -<a class="link" href="GtkIconTheme.html#GTK-ICON-LOOKUP-USE-BUILTIN:CAPS"><code class="literal">GTK_ICON_LOOKUP_USE_BUILTIN</code></a> to -<a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> structure</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the built-in image pixbuf, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. No -extra reference is added to the returned pixbuf, so if -you want to keep it around, you must use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>. -The returned image must not be modified. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-load-icon"></a><h3>gtk_icon_info_load_icon ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gtk_icon_info_load_icon (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> -<p> -Renders an icon previously looked up in an icon theme using -<a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a>; the size will be based on the size -passed to <a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a>. Note that the resulting -pixbuf may not be exactly this size; an icon theme may have icons -that differ slightly from their nominal sizes, and in addition GTK+ -will avoid scaling icons that it considers sufficiently close to the -requested size or for which the source image would have to be scaled -up too far. (This maintains sharpness.). This behaviour can be changed -by passing the <a class="link" href="GtkIconTheme.html#GTK-ICON-LOOKUP-FORCE-SIZE:CAPS"><code class="literal">GTK_ICON_LOOKUP_FORCE_SIZE</code></a> flag when obtaining -the <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a>. If this flag has been specified, the pixbuf -returned by this function will be scaled to the exact size. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> structure from <a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> -<td>location to store error information on failure, -or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the rendered icon; this may be a newly -created icon or a new reference to an internal icon, so you must -not modify the icon. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release your reference -to the icon. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-load-symbolic"></a><h3>gtk_icon_info_load_symbolic ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gtk_icon_info_load_symbolic (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *fg</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *success_color</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *warning_color</code></em>, - <em class="parameter"><code>const <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> *error_color</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *was_symbolic</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> -<p> -Loads an icon, modifying it to match the system colours for the foreground, -success, warning and error colors provided. If the icon is not a symbolic -one, the function will return the result from <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()"><code class="function">gtk_icon_info_load_icon()</code></a>. -</p> -<p> -This allows loading symbolic icons that will match the system theme. -</p> -<p> -Unless you are implementing a widget, you will want to use -<a href="http://library.gnome.org/devel/gio/unstable/GThemedIcon.html#g-themed-icon-new-with-default-fallbacks"><code class="function">g_themed_icon_new_with_default_fallbacks()</code></a> to load the icon. -</p> -<p> -As implementation details, the icon loaded needs to be of SVG type, -contain the "symbolic" term as the last component of the icon name, -and use the 'fg', 'success', 'warning' and 'error' CSS styles in the -SVG file itself. -</p> -<p> -See the <a class="ulink" href="http://www.freedesktop.org/wiki/SymbolicIcons" target="_top">Symbolic Icons spec</a> -for more information about symbolic icons. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>fg</code></em> :</span></p></td> -<td>a <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the foreground color of the icon</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>success_color</code></em> :</span></p></td> -<td>a <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the warning color -of the icon or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the default color. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>warning_color</code></em> :</span></p></td> -<td>a <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the warning color -of the icon or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the default color. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>error_color</code></em> :</span></p></td> -<td>a <a href="http://developer.gnome.org/gdk/gdk3-RGBA-Colors.html#GdkRGBA"><span class="type">GdkRGBA</span></a> representing the error color -of the icon or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the default color (allow-none). <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>was_symbolic</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>, returns whether the -loaded icon was a symbolic one and whether the <em class="parameter"><code>fg</code></em> color was -applied to it. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> -<td>location to store error information on failure, -or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> representing the loaded icon. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-load-symbolic-for-style"></a><h3>gtk_icon_info_load_symbolic_for_style ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gtk_icon_info_load_symbolic_for_style - (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> *style</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *was_symbolic</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_icon_info_load_symbolic_for_style</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-symbolic-for-context" title="gtk_icon_info_load_symbolic_for_context ()"><code class="function">gtk_icon_info_load_symbolic_for_context()</code></a> instead</p> -</div> -<p> -Loads an icon, modifying it to match the system colours for the foreground, -success, warning and error colors provided. If the icon is not a symbolic -one, the function will return the result from <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()"><code class="function">gtk_icon_info_load_icon()</code></a>. -</p> -<p> -This allows loading symbolic icons that will match the system theme. -</p> -<p> -See <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-symbolic" title="gtk_icon_info_load_symbolic ()"><code class="function">gtk_icon_info_load_symbolic()</code></a> for more details. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td> -<td>a <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> to take the colors from</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>state</code></em> :</span></p></td> -<td>the widget state to use for colors</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>was_symbolic</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>, returns whether the -loaded icon was a symbolic one and whether the <em class="parameter"><code>fg</code></em> color was -applied to it. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> -<td>location to store error information on failure, -or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> representing the loaded icon. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-load-symbolic-for-context"></a><h3>gtk_icon_info_load_symbolic_for_context ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gtk_icon_info_load_symbolic_for_context - (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *was_symbolic</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> -<p> -Loads an icon, modifying it to match the system colors for the foreground, -success, warning and error colors provided. If the icon is not a symbolic -one, the function will return the result from <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()"><code class="function">gtk_icon_info_load_icon()</code></a>. -This function uses the regular foreground color and the symbolic colors -with the names "success_color", "warning_color" and "error_color" from -the context. -</p> -<p> -This allows loading symbolic icons that will match the system theme. -</p> -<p> -See <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-symbolic" title="gtk_icon_info_load_symbolic ()"><code class="function">gtk_icon_info_load_symbolic()</code></a> for more details. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>a <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>was_symbolic</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>, returns whether the -loaded icon was a symbolic one and whether the <em class="parameter"><code>fg</code></em> color was -applied to it. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> -<td>location to store error information on failure, -or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> representing the loaded icon. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-set-raw-coordinates"></a><h3>gtk_icon_info_set_raw_coordinates ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_icon_info_set_raw_coordinates (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> raw_coordinates</code></em>);</pre> -<p> -Sets whether the coordinates returned by <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-embedded-rect" title="gtk_icon_info_get_embedded_rect ()"><code class="function">gtk_icon_info_get_embedded_rect()</code></a> -and <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-attach-points" title="gtk_icon_info_get_attach_points ()"><code class="function">gtk_icon_info_get_attach_points()</code></a> should be returned in their -original form as specified in the icon theme, instead of scaled -appropriately for the pixbuf returned by <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()"><code class="function">gtk_icon_info_load_icon()</code></a>. -</p> -<p> -Raw coordinates are somewhat strange; they are specified to be with -respect to the unscaled pixmap for PNG and XPM icons, but for SVG -icons, they are in a 1000x1000 coordinate space that is scaled -to the final size of the icon. You can determine if the icon is an SVG -icon by using <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-filename" title="gtk_icon_info_get_filename ()"><code class="function">gtk_icon_info_get_filename()</code></a>, and seeing if it is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -and ends in '.svg'. -</p> -<p> -This function is provided primarily to allow compatibility wrappers -for older API's, and is not expected to be useful for applications. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>raw_coordinates</code></em> :</span></p></td> -<td>whether the coordinates of embedded rectangles -and attached points should be returned in their original -(unscaled) form.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-get-embedded-rect"></a><h3>gtk_icon_info_get_embedded_rect ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_icon_info_get_embedded_rect (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rectangle</code></em>);</pre> -<p> -Gets the coordinates of a rectangle within the icon -that can be used for display of information such -as a preview of the contents of a text file. -See <a class="link" href="GtkIconTheme.html#gtk-icon-info-set-raw-coordinates" title="gtk_icon_info_set_raw_coordinates ()"><code class="function">gtk_icon_info_set_raw_coordinates()</code></a> for further -information about the coordinate system. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>rectangle</code></em> :</span></p></td> -<td> -<a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> in which to store embedded -rectangle coordinates; coordinates are only stored -when this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon has an embedded rectangle</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-get-attach-points"></a><h3>gtk_icon_info_get_attach_points ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_icon_info_get_attach_points (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkPoint"><span class="type">GdkPoint</span></a> **points</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_points</code></em>);</pre> -<p> -Fetches the set of attach points for an icon. An attach point -is a location in the icon that can be used as anchor points for attaching -emblems or overlays to the icon. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>points</code></em> :</span></p></td> -<td>location to store pointer to an array of points, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -free the array of points with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_points][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>n_points</code></em> :</span></p></td> -<td>location to store the number of points in <em class="parameter"><code>points</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if there are any attach points for the icon.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-icon-info-get-display-name"></a><h3>gtk_icon_info_get_display_name ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_icon_info_get_display_name (<em class="parameter"><code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> *icon_info</code></em>);</pre> -<p> -Gets the display name for an icon. A display name is a -string to be used in place of the icon name in a user -visible context like a list of icons. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_info</code></em> :</span></p></td> -<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo"><span class="type">GtkIconInfo</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the display name for the icon or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, if -the icon doesn't have a specified display name. This value -is owned <em class="parameter"><code>icon_info</code></em> and must not be modified or free.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -</div> -<div class="refsect1"> -<a name="GtkIconTheme.signal-details"></a><h2>Signal Details</h2> -<div class="refsect2"> -<a name="GtkIconTheme-changed"></a><h3>The <code class="literal">"changed"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> *icon_theme, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> -<p> -Emitted when the current icon theme is switched or GTK+ detects -that a change has occurred in the contents of the current -icon theme. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_theme</code></em> :</span></p></td> -<td>the icon theme</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -</div> -</div> -<div class="footer"> -<hr> - Generated by GTK-Doc V1.18.1</div> -</body> -</html>
\ No newline at end of file |