构造函数

GtkImagenew_from_file

声明 [源]

GtkWidget*
gtk_image_new_from_file (
  const char* filename
)

描述 [源]

创建一个新的 GtkImage，显示指定的文件 filename。

如果文件找不到或无法加载，则生成的 GtkImage 将显示“破损图片”图标。此函数永远不会返回 NULL，它始终返回一个有效的 GtkImage 小部件。

如果您需要检测加载文件失败，请使用 gdk_texture_new_from_file() 自行加载文件，然后从纹理创建 GtkImage。

返回的图像的存储类型（见 gtk_image_get_storage_type()）未定义，它将适用于显示文件的任何类型。

参数

filename

类型： const char*

文件名。

数据由函数的调用者拥有。
该值是一个平台原生的字符串，在 Unix 上使用首选 OS 编码，在 Windows 上使用 UTF-8。

返回值

类型： GtkWidget

一个新的 GtkImage。

数据由被调用函数拥有。