类
GdkTexture
说明 [src]
abstract class Gdk.Texture : GObject.Object
implements Gdk.Paintable, Gio.Icon, Gio.LoadableIcon {
/* No available fields */
}
GdkTexture
是用于引用像素数据的基本元素。
它主要用于不会在多帧中更改且将在长时间内使用的像素数据。
有各种方法可用于从 GdkPixbuf
或从存储在内存、文件或 GResource
中的字节创建 GdkTexture
对象。
像素数据的拥有权已传输到 GdkTexture
实例;您只能通过 gdk_texture_download()
制作其副本。
GdkTexture
是一个不可变对象:这意味着除了通过 g_object_ref()
增加引用计数以外,您无法更改它,因此,它是一个线程安全的对象。
GDK 提供了许多线程安全纹理加载函数:gdk_texture_new_from_resource()
、gdk_texture_new_from_bytes()
、gdk_texture_new_from_file()
、gdk_texture_new_from_filename()
、gdk_texture_new_for_pixbuf()
。请注意,这些函数旨在加载随工具套件或应用程序一起提供的图标和资源。如果您需要加载不受信任的图像数据,建议您使用专用图像加载框架,例如 glycin。
实例方法
从 GdkPaintable (9)继承的方法
gdk_paintable_compute_concrete_size
为 `GdkPaintable` 计算一个具体尺寸。
gdk_paintable_get_current_image
获取 `paintable` 显示的当前内容的不变 paintable。
gdk_paintable_get_flags
获取 `paintable` 的标志。
gdk_paintable_get_intrinsic_aspect_ratio
获取 `paintable` 希望显示的首选纵横比。
gdk_paintable_get_intrinsic_height
获取 `paintable` 希望显示的首选高度。
gdk_paintable_get_intrinsic_width
获取 `paintable` 希望显示的首选宽度。
gdk_paintable_invalidate_contents
`GdkPaintable` 的实现通过此方法使内容无效。
gdk_paintable_invalidate_size
`GdkPaintable` 的实现通过此方法使尺寸无效。
gdk_paintable_snapshot
使用给定的 `width` 和 `height`,对给定的 paintable 进行快照。
从 GIcon(4)继承的方法
g_icon_equal
检查两个图标是否相等。
g_icon_hash
获取图标的哈希值。
g_icon_serialize
将 `GIcon` 序列化为 `GVariant`。通过对返回的值调用 `g_icon_deserialize()`,可检索等效的 `GIcon`。由于序列化若可能,将会避免使用原始图标数据,因此仅在相同的计算机(而非通过网络),以及在相同的文件系统名称空间中,将 `GVariant` 传递给不同的进程才有意义。
g_icon_to_string
生成 `icon` 的文本表示,该文本表示可用于序列化,例如,将 `icon` 传递给不同的进程或将它保存到持久性存储设备。使用 `g_icon_new_for_string()` 根据返回的字符串获取 `icon`。
从 GLoadableIcon(3)继承的方法
g_loadable_icon_load
加载可加载图标。有关此函数的异步版本,请参阅 `g_loadable_icon_load_async()`。
g_loadable_icon_load_async
异步加载图标。若要完成此函数,请参阅 g_loadable_icon_load_finish()。有关此函数的同步块版本,请参阅 `g_loadable_icon_load()`。
g_loadable_icon_load_finish
完成在 `g_loadable_icon_load_async()` 中启动的异步图标加载。
信号
从 GObject 继承的信号 (1)
GObject::notify
当某个对象的一个属性通过 g_object_set_property()、g_object_set() 等函数设置其值时,就会发出 notify 信号。
从 GdkPaintable 继承的信号 (2)
GdkPaintable::invalidate-contents
当 paintable
的内容更改时发出。
GdkPaintable::invalidate-size
当 paintable
的固有大小更改时发出。