结构

GdkContentFormats

描述 [src]

struct GdkContentFormats {
  /* No available fields */
}

GdkContentFormats 结构用于通告和协商内容 格式。

在操作对象控制在不同小组件、窗口或应用程序之间传递数据时会遇到 GdkContentFormats,就像 GdkDragGdkDropGdkClipboardGdkContentProvider

GDK 支持 2 种形式的内容:GType 和 MIME 类型。使用 GTypes 仅适用于进程内内容传递。MIME 类型适用于进程内外数据传递。有关如何传递数据的详细信息在实际实现的文档中有所描述。如需在两种形式之间转换,可以使用 GdkContentSerializerGdkContentDeserializer

GdkContentFormats 描述可以交换内容的一组可能的格式。我们假设该组是有序的。GTypes 比 MIME 类型更重要。不同 GTypes 或 MIME 类型之间的顺序是它们添加的顺序,最重要优先。关心顺序的函数,例如 gdk_content_formats_union(),将在其文档中描述它们如何解释该顺序,尽管通常第一个参数的顺序被视为结果的主要顺序,后面 参数的顺序次之。

为了调试目的, gdk_content_formats_to_string() 函数应运而生。它将按照从最重要到最不重要的顺序打印一个逗号分隔的格式列表。

GdkContentFormats 是不可变结构。创建后,无法更改其表示的类型。必须创建新的 GdkContentFormatsGdkContentFormatsBuilder 结构旨在帮助 完成这项工作。

构造函数

gdk_content_formats_new

根据 MIME 类型数组创建一个新的 GdkContentFormats

gdk_content_formats_new_for_gtype

为给定的 GType 创建一个新的 GdkContentFormats

函数

gdk_content_formats_parse

将给定的 string 解析到 GdkContentFormats 并返回 formats。

since: 4.4

实例方法

gdk_content_formats_contain_gtype

检查给定的 GType 是否是给定的 formats 的一部分。

gdk_content_formats_contain_mime_type

检查给定的 MIME 类型是否是给定 formats 的一部分。

gdk_content_formats_get_gtypes

获取 formats 中包含的 GType

gdk_content_formats_get_mime_types

获取 formats 中包含的 MIME 类型。

gdk_content_formats_is_empty

返回内容格式是否包含任何 formats。

不稳定 since: 4.18

gdk_content_formats_match

检查 firstsecond 是否具有任何匹配的 formats。

gdk_content_formats_match_gtype

first 中查找第一个也包含在 second 中的 GType

gdk_content_formats_match_mime_type

first 中查找第一个也包含在 second 中的 MIME 类型。

gdk_content_formats_print

将给定的 formats 打印到字符串中以供人工 使用。

gdk_content_formats_ref

GdkContentFormats 的引用计数加一。

gdk_content_formats_to_string

将给定的 formats 打印到可读的 string。

gdk_content_formats_union

second 中缺少的所有类型追加到 first 中,按照它们在 second 中的顺序。

gdk_content_formats_union_deserialize_gtypes

添加已注册了反序列化程序的 MIME 类型的 GType 到 formats

gdk_content_formats_union_deserialize_mime_types

添加已注册了反序列化程序的 GType 的 MIME 类型到 formats

gdk_content_formats_union_serialize_gtypes

添加已注册了序列化程序的 formats 中 MIME 类型的 GType。

gdk_content_formats_union_serialize_mime_types

添加已注册了序列化程序的 formats 中 GType 的 MIME 类型。

gdk_content_formats_unref

GdkContentFormats 的引用计数减一。