Public Member Functions |
void | reference () const |
| Increment the reference count for this object.
|
void | unreference () const |
| Decrement the reference count for this object.
|
GtkIconSet* | gobj () |
| Provides access to the underlying C instance.
|
const GtkIconSet* | gobj () const |
| Provides access to the underlying C instance.
|
GtkIconSet* | gobj_copy () const |
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
|
Glib::RefPtr< IconSet > | copy () const |
| Copies icon_set by value.
|
Glib::RefPtr< Gdk::Pixbuf > | render_icon_pixbuf (const Glib::RefPtr< StyleContext >& context, IconSize size) |
| Renders an icon using gtk_render_icon_pixbuf().
|
void | add_source (const IconSource& source) |
| Icon sets have a list of Gtk::IconSource, which they use as base icons for rendering icons in different states and sizes.
|
std::vector< IconSize > | get_sizes () const |
This manages a set of variants of a particular icon An IconSet contains variants for different sizes and widget states.
Icons in an icon factory are named by a stock ID, which is a simple string identifying the icon. Each GtkStyle has a list of GtkIconFactory derived from the current theme; those icon factories are consulted first when searching for an icon. If the theme doesn't set a particular icon, GTK+ looks for the icon in a list of default icon factories, maintained by gtk_icon_factory_add_default() and gtk_icon_factory_remove_default(). Applications with icons should add a default icon factory with their icons, which will allow themes to override the icons for the application.
void Gtk::IconSet::add_source |
( |
const IconSource& |
source | ) |
|
Icon sets have a list of Gtk::IconSource, which they use as base icons for rendering icons in different states and sizes.
Icons are scaled, made to look insensitive, etc. in render_icon(), but Gtk::IconSet needs base images to work with. The base images and when to use them are described by a Gtk::IconSource.
This function copies source, so you can reuse the same source immediately without affecting the icon set.
An example of when you'd use this function: a web browser's "Back
to Previous Page" icon might point in a different direction in Hebrew and in English; it might look different when insensitive; and it might change size depending on toolbar mode (small/large icons). So a single icon set would contain all those variants of the icon, and you might add a separate source for each one.
You should nearly always add a "default" icon source with all fields wildcarded, which will be used as a fallback if no more specific source matches. Gtk::IconSet always prefers more specific icon sources to more generic icon sources. The order in which you add the sources to the icon set does not matter.
new_from_pixbuf() creates a new icon set with a default icon source based on the given pixbuf.
- Parameters
-