类

GtkPicture

说明 [src]

final class Gtk.Picture : Gtk.Widget
  implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget {
  /* No available fields */
}

GtkPicture 窗口小部件显示了一个 GdkPaintable。

An example GtkPicture

提供了许多便利函数来简化图片的使用。例如，如果你想从文件中加载一张图片并显示时，有一个便利的函数如下所示

GtkWidget *widget = gtk_picture_new_for_filename ("myfile.png");

如果文件加载不成功，图片将包含一个“损坏图片”的图标，类似于许多网络浏览器中使用的图标。如果你想自己处理文件加载错误，例如显示错误消息，则使用 gdk_texture_new_from_file() 加载图像，然后使用 gtk_picture_new_for_paintable() 创建 GtkPicture。

有时应用程序需要避免依赖于外部数据文件，例如图像文件。有关详细信息，请参阅 GResource 的文档。在这种情况下，应使用 gtk_picture_new_for_resource() 和 gtk_picture_set_resource()。

GtkPicture 以其自然大小显示图像。如果你想要显示一个固定大小的图像，例如一个图标，请参阅 GtkImage。

调整可绘制的大小

通过更改 GtkPicture:content-fit，你可以影响可绘制的显示方式。有关详细信息，请参阅 GtkContentFit。可以取消设置 GtkPicture:can-shrink 以确保可绘制项永远不会小于其理想的大小 - 但如果不知道正在使用的可绘制项的大小（如显示用户加载的图像时），请务必小心。这样很容易导致图片增长得比屏幕大。并且可以利用 GtkWidget:halign 和 GtkWidget:valign 确保可绘制项不能填满所有可用空间，而是以其原始大小显示。

CSS节点

GtkPicture有单个CSS节点，其名称为picture。

辅助功能

GtkPicture使用GTK_ACCESSIBLE_ROLE_IMG角色。

层级

祖先

实现

从GtkWidget（162）继承的方法

有关方法的完整列表，请参阅 GtkWidget 。

从GObject（43）继承的方法

有关方法的完整列表，请参阅 GObject 。

方法继承自 GtkBuildable (1)

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

从 GtkAccessible (1) 继承的属性

GtkAccessible:accessible-role

给定 GtkAccessible 实现的可访问角色。

信号

从 GObject (1) 继承的信号

GObject::notify

当对象的属性通过 g_object_set_property()、g_object_set() 及其他函数设置其值时，会在对象上发出通知信号。

类结构

struct GtkPictureClass {
  GtkWidgetClass parent_class;
  
}

没有可用描述。

类成员

parent_class: GtkWidgetClass: 没有可用描述。

说明 [src]

调整可绘制的大小

CSS节点

辅助功能

层级

祖先

实现

构造函数

实例方法

从GtkWidget（162）继承的方法

从GObject（43）继承的方法

从GtkAccessible（19）继承的方法

方法继承自 GtkBuildable (1)

属性

继承自 GtkWidget (34) 的属性

从 GtkAccessible (1) 继承的属性

信号

从 GtkWidget (13) 继承的信号

从 GObject (1) 继承的信号

类结构

类成员