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 |
const gchar* |
A filename. |
|
The data is owned by the caller of the function. | |
The value is a file system path, using the OS encoding. |
Return value
Returns: | GtkWidget |
A new |
|
The data is owned by the called function. |