Image

Object Hierarchy:

Description:

	GtkWidget *image;
	image = gtk_image_new_from_file ("myfile.png");

	static gboolean
	button_press_callback (GtkWidget			*event_box,
												 GdkEventButton *event,
												 gpointer				data)
	{
		g_print ("Event box clicked at coordinates %f,%f\n",
						 event->x, event->y);

		// Returning TRUE means we handled the event, so the signal
		// emission should be stopped (don’t call any further callbacks
		// that may be connected). Return FALSE to continue invoking callbacks.
		return TRUE;
	}

	static GtkWidget*
	create_image (void)
	{
		GtkWidget *image;
		GtkWidget *event_box;

		image = gtk_image_new_from_file ("myfile.png");

		event_box = gtk_event_box_new ();

		gtk_container_add (GTK_CONTAINER (event_box), image);

		g_signal_connect (G_OBJECT (event_box),
											"button_press_event",
											G_CALLBACK (button_press_callback),
											image);

		return image;
	}

Content:

Properties:

• public string file { owned get; set; }
• public Icon gicon { owned get; set; }
  The GIcon displayed in the GtkImage.
• public string icon_name { owned get; set; }
  The name of the icon in the icon theme.
• public IconSet icon_set { owned get; set; }
• public int icon_size { get; set; }
• public Pixbuf pixbuf { owned get; set; }
• public PixbufAnimation pixbuf_animation { owned get; set; }
• public int pixel_size { get; set; }
  The "pixel-size" property can be used to specify a fixed size overriding the icon_size property for images of type gtk_image_icon_name.
• public string resource { owned get; set; }
  A path to a resource file to display.
• public string stock { owned get; set; }
• public ImageType storage_type { get; }
• public Surface surface { owned get; set; }
• public bool use_fallback { get; set; }
  Whether the icon displayed in the GtkImage will use standard icon names fallback.

Creation methods:

• public Image ()
  Creates a new empty Image widget.
• public Image.from_animation (PixbufAnimation animation)
  Creates a Image displaying the given animation.
• public Image.from_file (string filename)
  Creates a new Image displaying the file filename.
• public Image.from_gicon (Icon icon, IconSize size)
  Creates a Image displaying an icon from the current icon theme.
• public Image.from_icon_name (string? icon_name, IconSize size)
  Creates a Image displaying an icon from the current icon theme.
• public Image.from_icon_set (IconSet icon_set, IconSize size)
  Creates a Image displaying an icon set.
• public Image.from_pixbuf (Pixbuf? pixbuf)
  Creates a new Image displaying pixbuf .
• public Image.from_resource (string resource_path)
  Creates a new Image displaying the resource file resource_path.
• public Image.from_stock (string stock_id, IconSize size)
  Creates a Image displaying a stock icon.
• public Image.from_surface (Surface? surface)
  Creates a new Image displaying surface.

Methods:

• public void clear ()
  Resets the image to be empty.
• public unowned PixbufAnimation? get_animation ()
  Gets the PixbufAnimation being displayed by the Image.
• public void get_gicon (out unowned Icon gicon, out IconSize size)
  Gets the Icon and size being displayed by the Image.
• public void get_icon_name (out unowned string icon_name, out IconSize size)
  Gets the icon name and size being displayed by the Image.
• public void get_icon_set (out unowned IconSet icon_set, out IconSize size)
  Gets the icon set and size being displayed by the Image.
• public unowned Pixbuf? get_pixbuf ()
  Gets the Pixbuf being displayed by the Image.
• public int get_pixel_size ()
  Gets the pixel size used for named icons.
• public void get_stock (out unowned string stock_id, out IconSize size)
  Gets the stock icon name and size being displayed by the Image.
• public ImageType get_storage_type ()
  Gets the type of representation being used by the Image to store image data.
• public void set_from_animation (PixbufAnimation animation)
  Causes the Image to display the given animation (or display nothing, if you set the animation to null).
• public void set_from_file (string? filename)
  See Image.from_file for details.
• public void set_from_gicon (Icon icon, IconSize size)
  See Image.from_gicon for details.
• public void set_from_icon_name (string? icon_name, IconSize size)
  See Image.from_icon_name for details.
• public void set_from_icon_set (IconSet icon_set, IconSize size)
  See Image.from_icon_set for details.
• public void set_from_pixbuf (Pixbuf? pixbuf)
  See Image.from_pixbuf for details.
• public void set_from_resource (string? resource_path)
  See Image.from_resource for details.
• public void set_from_stock (string stock_id, IconSize size)
  See Image.from_stock for details.
• public void set_from_surface (Surface? surface)
  See Image.from_surface for details.
• public void set_pixel_size (int pixel_size)
  Sets the pixel size to use for named icons.

Inherited Members: