|  |  | 

The Gtk::Image widget displays an image. Various kinds of object can be displayed as an image; most typically, you would load a Gdk::Pixbuf ("pixel buffer") from a file, and then display that.
Gtk::Image is a subclass of Gtk::Misc, which implies that you can align it (center, left, right) and add padding to it, using Gtk::Misc methods.
Gtk::Image is a "no window" widget (has no Gdk::Window of its own), so by default does not receive events. If you want to receive events on the image, such as button clicks, place the image inside a Gtk::EventBox, then connect to the event signals on the event box.
| Public Member Functions | |
| virtual | ~Image () | 
| GtkImage* | gobj () | 
| Provides access to the underlying C GtkObject. | |
| const GtkImage* | gobj () const | 
| Provides access to the underlying C GtkObject. | |
| Image () | |
| Image (const Glib::RefPtr<Gdk::Pixmap>& pixmap, const Glib::RefPtr<Gdk::Bitmap>& mask) | |
| Image (const Glib::RefPtr<Gdk::Image>& image, const Glib::RefPtr<Gdk::Bitmap>& mask) | |
| Image (const std::string& file) | |
| Image (const Glib::RefPtr<Gdk::Pixbuf>& pixbuf) | |
| Image (const Gtk::StockID& stock_id, IconSize size) | |
| Image (IconSet& icon_set, IconSize size) | |
| Image (const Glib::RefPtr<Gdk::PixbufAnimation>& animation) | |
| void | set (const Glib::RefPtr<Gdk::Pixmap>& pixmap, const Glib::RefPtr<Gdk::Bitmap>& mask) | 
| See new_from_pixmap() for details. | |
| void | set (const Glib::RefPtr<Gdk::Image>& gdk_image, const Glib::RefPtr<Gdk::Bitmap>& mask) | 
| See new_from_image() for details. | |
| void | set (const std::string& filename) | 
| See new_from_file() for details. | |
| void | set (const Glib::RefPtr<Gdk::Pixbuf>& pixbuf) | 
| See new_from_pixbuf() for details. | |
| void | set (const Gtk::StockID& stock_id, IconSize size) | 
| See new_from_stock() for details. | |
| void | set (IconSet& icon_set, IconSize size) | 
| See new_from_icon_set() for details. | |
| void | set (const Glib::RefPtr<Gdk::PixbufAnimation>& animation) | 
| Causes the Gtk::Image to display the given animation (or display nothing, if you set the animation to 0). | |
| void | clear () | 
| ImageType | get_storage_type () const | 
| Gets the type of representation being used by the Gtk::Image to store image data. | |
| void | get_pixmap (Glib::RefPtr<Gdk::Pixmap>& pixmap, Glib::RefPtr<Gdk::Bitmap>& mask) const | 
| void | get_image (Glib::RefPtr<Gdk::Image>& gdk_image, Glib::RefPtr<Gdk::Bitmap>& mask) const | 
| Glib::RefPtr<Gdk::Pixbuf> | get_pixbuf () | 
| Gets the Gdk::Pixbuf being displayed by the Gtk::Image. | |
| Glib::RefPtr<const Gdk::Pixbuf> | get_pixbuf () const | 
| Gets the Gdk::Pixbuf being displayed by the Gtk::Image. | |
| void | get_stock (Gtk::StockID& stock_id, IconSize& size) const | 
| void | get_icon_set (IconSet& icon_set, IconSize& size) const | 
| Glib::RefPtr<Gdk::PixbufAnimation> | get_animation () | 
| Gets the Gdk::PixbufAnimation being displayed by the Gtk::Image. | |
| Glib::RefPtr<const Gdk::PixbufAnimation> | get_animation () const | 
| Gets the Gdk::PixbufAnimation being displayed by the Gtk::Image. | |
| Glib::PropertyProxy< Glib::RefPtr< Gdk::Pixbuf > > | property_pixbuf () | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gdk::Pixbuf >> | property_pixbuf () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy< Glib::RefPtr< Gdk::Pixmap > > | property_pixmap () | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gdk::Pixmap >> | property_pixmap () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy< Glib::RefPtr< Gdk::Image > > | property_image () | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gdk::Image >> | property_image () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy< Glib::RefPtr< Gdk::Pixmap > > | property_mask () | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gdk::Pixmap >> | property_mask () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_WriteOnly< Glib::ustring > | property_file () | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_file () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy<Glib::ustring> | property_stock () | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_stock () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy<Gtk::IconSet> | property_icon_set () | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< Gtk::IconSet > | property_icon_set () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy<int> | property_icon_size () | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< int > | property_icon_size () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy< Glib::RefPtr< Gdk::PixbufAnimation > > | property_pixbuf_animation () | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gdk::PixbufAnimation >> | property_pixbuf_animation () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Glib::PropertyProxy_ReadOnly< ImageType > | property_storage_type () const | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
| Related Functions | |
| (Note that these are not member functions.) | |
| Gtk::Image* | wrap (GtkImage* object, bool take_copy=false) | 
| 
 | 
| 
 | 
| 
 | 
| 
 | 
| 
 | ||||||||||||
| 
 | 
| 
 | ||||||||||||
| 
 | 
| 
 | 
| 
 | 
| 
 | 
| 
 | 
| 
 | ||||||||||||
| 
 | 
| 
 | ||||||||||||
| 
 | 
| 
 | 
| 
 | 
| 
 | 
| 
 | 
| 
 | 
| Gets the Gdk::PixbufAnimation being displayed by the Gtk::Image. The storage type of the image must be Gtk::IMAGE_EMPTY or Gtk::IMAGE_ANIMATION (see get_storage_type()). The caller of this function does not own a reference to the returned animation. 
 | 
| 
 | 
| Gets the Gdk::PixbufAnimation being displayed by the Gtk::Image. The storage type of the image must be Gtk::IMAGE_EMPTY or Gtk::IMAGE_ANIMATION (see get_storage_type()). The caller of this function does not own a reference to the returned animation. 
 | 
| 
 | ||||||||||||
| 
 | 
| 
 | ||||||||||||
| 
 | 
| 
 | 
| Gets the Gdk::Pixbuf being displayed by the Gtk::Image. The storage type of the image must be Gtk::IMAGE_EMPTY or Gtk::IMAGE_PIXBUF (see get_storage_type()). The caller of this function does not own a reference to the returned pixbuf. 
 | 
| 
 | 
| Gets the Gdk::Pixbuf being displayed by the Gtk::Image. The storage type of the image must be Gtk::IMAGE_EMPTY or Gtk::IMAGE_PIXBUF (see get_storage_type()). The caller of this function does not own a reference to the returned pixbuf. 
 | 
| 
 | ||||||||||||
| 
 | 
| 
 | ||||||||||||
| 
 | 
| 
 | 
| Gets the type of representation being used by the Gtk::Image to store image data. If the Gtk::Image has no image data, the return value will be Gtk::IMAGE_EMPTY. 
 | 
| 
 | 
| Provides access to the underlying C GtkObject. 
 Reimplemented from Gtk::Misc. 
 | 
| 
 | 
| Provides access to the underlying C GtkObject. 
 Reimplemented from Gtk::Misc. 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| You rarely need to use properties because there are get_ and set_ methods for almost all of them. 
 
 | 
| 
 | 
| 
Causes the Gtk::Image to display the given animation (or display nothing, if you set the animation to  
 
 | 
| 
 | ||||||||||||
| See new_from_icon_set() for details. 
 
 | 
| 
 | ||||||||||||
| See new_from_stock() for details. 
 
 | 
| 
 | 
| See new_from_pixbuf() for details. 
 
 | 
| 
 | 
| See new_from_file() for details. 
 
 | 
| 
 | ||||||||||||
| See new_from_image() for details. 
 
 | 
| 
 | ||||||||||||
| See new_from_pixmap() for details. 
 
 | 
| 
 | ||||||||||||
| 
 
 
 |