A widget displaying an image
The GtkImage widget displays an image. Various kinds of object can be displayed as an image; most typically, you would load a GdkPixbuf ("pixel buffer") from a file, and then display that. There's a convenience function to do this, GtkImage::new_from_file() , used as follows:
$img = GtkImage::new_from_file('/path/to/the/image.png');
If the file isn't loaded successfully, the image will contain a "broken image" icon similar to that used in many web browsers. If you want to handle errors in loading the file yourself, for example by displaying an error message, then load the image with GdkPixbuf::new_from_file() , then create the GtkImage with GtkImage::new_from_pixbuf() .
The image file may contain an animation, if so the GtkImage will display an animation (GdkPixbufAnimation) instead of a static image.
GtkImage is a "no window" widget (has no GdkWindow 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 GtkEventBox, then connect to the event signals on the event box.
GtkImage ();-- Creates a new GtkImage.GtkImage::new_from_file (filename);-- Creates a new GtkImage displaying a file.GtkImage::new_from_icon_name (icon_name, size);--
get_animation() Gets the GdkPixbufAnimation being displayed by the GtkImage. get_pixbuf() Gets the GdkPixbuf being displayed by the GtkImage. get_pixel_size() Gets the pixel size used for named icons. get_storage_type() Gets the type of representation being used by the GtkImage to store image data. set() Sets the image. set_from_animation() See GtkImage::new_from_animation() . set_from_file() See GtkImage::new_from_file() . set_from_icon_name() See GtkImage::new_from_stock() . set_from_icon_set() See GtkImage::new_from_icon_set() . set_from_image() See GtkImage::new_from_image() . set_from_pixbuf() See GtkImage::new_from_pixbuf() . set_from_pixmap() See GtkImage::new_from_pixmap() . set_from_stock() See GtkImage::new_from_stock() . set_pixel_size() Sets the pixel size to use for named icons.