![]() |
Public Member Functions | ||||
| 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. | ||||
| IconSet | copy () const | |||
| Copies icon_set by value. | ||||
| Glib::ArrayHandle<IconSize> | get_sizes () const | |||
| const GtkIconSet* | gobj () const | |||
| Provides access to the underlying C instance. | ||||
| GtkIconSet* | gobj () | |||
| Provides access to the underlying C instance. | ||||
| GtkIconSet* | gobj_copy () const | |||
| Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs. | ||||
| IconSet (const Glib::RefPtr<Gdk::Pixbuf>& pixbuf) | ||||
| IconSet (const IconSet& other) | ||||
| IconSet (GtkIconSet* gobject, bool make_a_copy=true) | ||||
| IconSet () | ||||
| IconSet& | operator= (const IconSet& other) | |||
| Glib::RefPtr<Gdk::Pixbuf> | render_icon (const Glib::RefPtr<Style>& style, TextDirection direction, Gtk::StateType state, IconSize size, Widget& widget, const Glib::ustring& detail) | |||
| Renders an icon using Gtk::Style::render_icon(). | ||||
| void | swap (IconSet& other) | |||
| ~IconSet () | ||||
Static Public Member Functions | ||||
| static IconSet | lookup_default (const Gtk::StockID& stock_id) | |||
Protected Attributes | ||||
| GtkIconSet* | gobject_ | |||
Related Functions | ||||
| (Note that these are not member functions.) | ||||
| void | swap (IconSet& lhs, IconSet& rhs) | |||
| ||||
| Gtk::IconSet | wrap (GtkIconSet* object, bool take_copy=false) | |||
| ||||
| Gtk::IconSet::IconSet | ( | ) |
| Gtk::IconSet::IconSet | ( | GtkIconSet * | gobject, | |
| bool | make_a_copy = true | |||
| ) | [explicit] |
| Gtk::IconSet::IconSet | ( | const IconSet& | other | ) |
| Gtk::IconSet::~IconSet | ( | ) |
| Gtk::IconSet::IconSet | ( | const Glib::RefPtr<Gdk::Pixbuf>& | pixbuf | ) | [explicit] |
| 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 gtk_icon_set_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.
gtk_icon_set_new_from_pixbuf() creates a new icon set with a default icon source based on the given pixbuf.
| source | A Gtk::IconSource. |
| IconSet Gtk::IconSet::copy | ( | ) | const |
| Glib::ArrayHandle<IconSize> Gtk::IconSet::get_sizes | ( | ) | const |
| const GtkIconSet* Gtk::IconSet::gobj | ( | ) | const [inline] |
Provides access to the underlying C instance.
| GtkIconSet* Gtk::IconSet::gobj | ( | ) | [inline] |
Provides access to the underlying C instance.
| GtkIconSet* Gtk::IconSet::gobj_copy | ( | ) | const |
Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs.
| static IconSet Gtk::IconSet::lookup_default | ( | const Gtk::StockID& | stock_id | ) | [static] |
| Glib::RefPtr<Gdk::Pixbuf> Gtk::IconSet::render_icon | ( | const Glib::RefPtr<Style>& | style, | |
| TextDirection | direction, | |||
| Gtk::StateType | state, | |||
| IconSize | size, | |||
| Widget& | widget, | |||
| const Glib::ustring & | detail | |||
| ) |
Renders an icon using Gtk::Style::render_icon().
In most cases, Gtk::Widget::render_icon() is better, since it automatically provides most of the arguments from the current widget settings. This function never returns 0; if the icon can't be rendered (perhaps because an image file fails to load), a default "missing image" icon will be returned instead.
| style | A Gtk::Style associated with widget , or 0. | |
| direction | Text direction. | |
| state | Widget state. | |
| size | Icon size. A size of (GtkIconSize)-1 means render at the size of the source and don't scale. | |
| widget | Widget that will display the icon, or 0. The only use that is typically made of this is to determine the appropriate Gdk::Screen. | |
| detail | Detail to pass to the theme engine, or 0. Note that passing a detail of anything but 0 will disable caching. |
| void Gtk::IconSet::swap | ( | IconSet& | other | ) |
| lhs | The left-hand side |
| rhs | The right-hand side |
| Gtk::IconSet wrap | ( | GtkIconSet * | object, | |
| bool | take_copy = false | |||
| ) | [related] |
| object | The C instance |
| take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |
GtkIconSet* Gtk::IconSet::gobject_ [protected] |