Constructor
Gtk.Image.new_from_file
Declaration [src]
GtkWidget*
gtk_image_new_from_file (
const char* 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 you need to detect failures to load the file, use
gdk_texture_new_from_file()
to load the file yourself,
then create the GtkImage
from the texture.
The storage type (see 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 char* |
a filename |
|
Ownership is not transferred to the callee | |
The string is a file system path, using the OS encoding |
Return value
Returns: GtkWidget |
|
a new |
|
Ownership is not transferred to the caller |