Constructor
GtkImagenew_from_file
Declaration [src]
GtkWidget*
gtk_image_new_from_file (
const gchar* filename
)
Description [src]
Creates a new GtkImage displaying the file filename. If the file
isn’t found or can’t be loaded, the resulting GtkImage will
display a “broken image” icon. This function never returns NULL,
it always returns a valid GtkImage widget.
If the file contains an animation, the image will contain an animation.
If you need to detect failures to load the file, use
gdk_pixbuf_new_from_file() to load the file yourself, then create
the GtkImage from the pixbuf. (Or for animations, use gdk_pixbuf_animation_new_from_file()).
The storage type (gtk_image_get_storage_type()) of the returned image is not defined, it will be whatever is appropriate for displaying the file.
Parameters
filename-
Type:
const gchar*A filename.
The data is owned by the caller of the function. The value is a platform-native string, using the preferred OS encoding on Unix and UTF-8 on Windows.
Return value
Type: GtkWidget
A new GtkImage.
| The data is owned by the called function. |