类
GtkImage
说明 [源代码]
final class Gtk.Image : Gtk.Widget
implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget {
/* No available fields */
}GtkImage 小组件显示一张图片。
各种类型的对象可以显示为图片；例如，你可以使用 gtk_image_new_from_file() 快捷函数从文件加载 GdkTexture
GtkWidget *image = gtk_image_new_from_file ("myfile.png");
如果未能成功加载文件，则图像将包含一个“损坏的图像”图标，类似于许多网络浏览器中使用的图标。
如果你要自己处理加载文件错误的问题，例如显示错误消息，可以使用 gdk_texture_new_from_file() 加载图像，然后使用 gtk_image_new_from_paintable() 创建 GtkImage。
有时应用程序需要避免依赖外部数据文件，如图像文件。有关详细信息，请参见 GIO 内的 GResource 文档。在这种情况下，应使用 GtkImage:resource、gtk_image_new_from_resource() 和 gtk_image_set_from_resource()。
GtkImage 以图标的形式显示其图像，图标的大小由应用程序确定。如果你想显示图像的实际大小，请参见 GtkPicture。
CSS 节点
GtkImage 有一个名为 image 的单个 CSS 节点。根据 GtkImage:icon-size 属性，可能会出现样式类 .normal-icons 或 .large-icons。
辅助功能
GtkImage 使用 GTK_ACCESSIBLE_ROLE_IMG 角色。
实例方法
从 GtkAccessible （19）继承的方法
gtk_accessible_announce
要求用户的屏幕阅读器播报给定的消息。
自：4.14
gtk_accessible_get_accessible_parent
检索可访问对象的父可访问对象。
自：4.10
gtk_accessible_get_accessible_role
检索可访问对象的可访问角色。
gtk_accessible_get_at_context
检索给定可访问对象的实现。
自：4.10
gtk_accessible_get_bounds
查询此可访问对象的坐标和维度。
自：4.10
gtk_accessible_get_first_accessible_child
检索可访问对象的第一个可访问子对象。
自：4.10
gtk_accessible_get_next_accessible_sibling
检索可访问对象的下一个可访问同级对象。
自：4.10
gtk_accessible_get_platform_state
查询平台状态，例如焦点。
自：4.10
gtk_accessible_reset_property
将可访问属性重置为其默认值。
gtk_accessible_reset_relation
将可访问关系重置为其默认值。
gtk_accessible_reset_state
将可访问状态重置为其默认值。
gtk_accessible_set_accessible_parent
设置可访问对象的父级和同级。
自：4.10
gtk_accessible_update_next_accessible_sibling
更新下一个可访问同级对象。
自：4.10
gtk_accessible_update_property
更新可访问属性列表。
gtk_accessible_update_property_value
更新一系列可访问的属性。
gtk_accessible_update_relation
更新一系列可访问的关系。
gtk_accessible_update_relation_value
更新一系列可访问的关系。
gtk_accessible_update_state
更新一系列可访问的状态。
gtk_accessible_update_state_value
更新一系列可访问的状态。
从 GtkBuildable 继承的方法 (1)
属性
从 GtkWidget 继承的属性 (34)
Gtk.Widget:can-focus
小部件或其任何子代是否能够获得输入焦点。
Gtk.Widget:can-target
小部件是否能够接收指针事件。
Gtk.Widget:css-classes
应用于该小部件的一系列 css 样式。
Gtk.Widget:css-name
在 CSS 树中该小部件的名称。
Gtk.Widget:cursor
widget 使用的光标。
Gtk.Widget:focus-on-click
使用鼠标单击小部件时，小部件是否应捕获焦点。
Gtk.Widget:focusable
该小部件本身是否将接受输入焦点。
Gtk.Widget:halign
如果小部件获得额外的空间，则如何分配水平空间。
Gtk.Widget:has-default
小部件是否为默认小部件。
Gtk.Widget:has-focus
小部件是否拥有输入焦点。
Gtk.Widget:has-tooltip
启用或禁用 widget 上 GtkWidget::query-tooltip 信号的发射。
Gtk.Widget:height-request
重写小部件的高度请求。
Gtk.Widget:hexpand
是否水平扩展。
Gtk.Widget:hexpand-set
是否使用 hexpand 属性。
Gtk.Widget:layout-manager
要用来计算小部件首选大小并分配其子代的 GtkLayoutManager 实例。
Gtk.Widget:margin-bottom
小部件底部的边距。
Gtk.Widget:margin-end
小部件末尾的边距（水平方向）。
Gtk.Widget:margin-start
小部件起始位置的边距（水平方向）。
Gtk.Widget:margin-top
小部件顶部的边距。
Gtk.Widget:name
小部件的名称。
Gtk.Widget:opacity
小部件请求的不透明度。
Gtk.Widget:overflow
如何处理小部件内容区域外部的内容。
Gtk.Widget:parent
该小部件的父小部件。
Gtk.Widget:receives-default
焦点处于该小部件时，该小部件是否将接收默认操作。
Gtk.Widget:root
包含该小部件的小部件树的 GtkRoot 小部件。
Gtk.Widget:scale-factor
小部件的缩放因子。
Gtk.Widget:sensitive
小部件是否响应输入。
Gtk.Widget:tooltip-markup
将工具提示的文本设置为给定的字符串，该字符串用 Pango 标示标记。
Gtk.Widget:tooltip-text
将工具提示的文本设置为给定的字符串。
Gtk.Widget:valign
如果小部件获得额外的空间，则如何分配垂直空间。
Gtk.Widget:vexpand
是否垂直扩展。
Gtk.Widget:vexpand-set
是否使用 vexpand 属性。
Gtk.Widget:visible
小部件是否可见。
Gtk.Widget:width-request
控件宽度请求的覆盖。
从 GtkAccessible 继承的属性 (1)
信号
从 GtkWidget 继承的信号 (13)
GtkWidget::destroy
所有持有控件引用的持有者都应释放他们持有的引用的信号。
GtkWidget::direction-changed
当控件的文本方向改变时发出。
GtkWidget::hide
当隐藏 widget 时发出。
GtkWidget::keynav-failed
如果键盘导航失败，则发出。
GtkWidget::map
当 widget 即将映射时发出。
GtkWidget::mnemonic-activate
通过助记符激活控件时发出。
GtkWidget::move-focus
当焦点移动时发出。
GtkWidget::query-tooltip
当控件的工具提示即将显示时发出。
GtkWidget::realize
当 widget 与 GdkSurface 关联时发出。
GtkWidget::show
当 widget 显示时发出。
GtkWidget::state-flags-changed
当控件状态改变时发出。
GtkWidget::unmap
当 widget 即将取消映射时发出。
GtkWidget::unrealize
当与 widget 关联的 GdkSurface 被销毁时发出。
从 GObject 继承的信号（1）
GObject::notify
当对象的某个属性的值通过 g_object_set_property()、g_object_set() 等设置时，该对象上会发出通知信号。