PHP-GTK
Sunday, November 23, 2014 
download | documentation | applications | faq | changelog | resources 


search for in the  


previousunselect-all
GtkImage Constructornext

Last updated: Sun, 12 May 2013
view this page in English

GtkImage

A widget displaying an image

Object Hierarchy

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.

--

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.


User Contributed Notes
gtk.gtkimage.php
add a note about notes
There are no user contributed notes for this page.


previousunselect-all
GtkImage Constructornext

Last updated: Sun, 12 May 2013
view this page in English


credits 

PHP  Copyright © 2001-2014 The PHP Group
 All rights reserved.
Last updated: Sun May 12 20:50:58 2013 CEST