GtkImage

A widget displaying an image

Object Hierarchy

GObject
`-- GtkObject
       `-- GtkWidget
              `-- GtkMisc
                     `-- GtkImage

Description

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 subclass of GtkMisc, which implies that you can align it (center, left, right) and add padding to it, using GtkMisc methods.

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.

Constructors

-- Creates a new GtkImage.

-- Creates a GtkImage displaying the given animation.

-- Creates a new GtkImage displaying a file.

-- Creates a GtkImage displaying an icon set.

-- Creates a GtkImage widget displaying a image with a mask.

-- Creates a new GtkImage displaying pixbuf.

-- Creates a GtkImage widget displaying pixmap with a mask.

-- Creates a GtkImage displaying a stock icon.

GtkImage::new_from_icon_name (icon_name, size);

--

Methods

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.