gdk.content_formats
Module for [ContentFormats] class
Types 1
The [gdk.content_formats.ContentFormats] structure is used to advertise and negotiate the format of content.
You will encounter [gdk.content_formats.ContentFormats] when interacting with objects controlling operations that pass data between different widgets, window or application, like [gdk.drag.Drag], [gdk.drop.Drop], [gdk.clipboard.Clipboard] or [gdk.content_provider.ContentProvider].
GDK supports content in 2 forms: GType and mime type. Using GTypes is meant only for in-process content transfers. Mime types are meant to be used for data passing both in-process and out-of-process. The details of how data is passed is described in the documentation of the actual implementations. To transform between the two forms, [gdk.content_serializer.ContentSerializer] and [gdk.content_deserializer.ContentDeserializer] are used.
A [gdk.content_formats.ContentFormats] describes a set of possible formats content can be exchanged in. It is assumed that this set is ordered. GTypes are more important than mime types. Order between different GTypes or mime types is the order they were added in, most important first. Functions that care about order, such as [gdk.content_formats.ContentFormats.union_], will describe in their documentation how they interpret that order, though in general the order of the first argument is considered the primary order of the result, followed by the order of further arguments.
For debugging purposes, the function [gdk.content_formats.ContentFormats.toString_] exists. It will print a comma-separated list of formats from most important to least important.
[gdk.content_formats.ContentFormats] is an immutable struct. After creation, you cannot change the types it represents. Instead, new [gdk.content_formats.ContentFormats] have to be created. The [gdk.content_formats_builder.ContentFormatsBuilder] structure is meant to help in this endeavor.
ContentFormats self()Returns `this`, for use in `with` statements.gdk.content_formats.ContentFormats newForGtype(gobject.types.GType type)Creates a new [gdk.content_formats.ContentFormats] for a given `GType`.bool containGtype(gobject.types.GType type)Checks if a given `GType` is part of the given formats.bool containMimeType(string mimeType)Checks if a given mime type is part of the given formats.gobject.types.GType[] getGtypes()Gets the `GType`s included in formats.string[] getMimeTypes()Gets the mime types included in formats.bool match(gdk.content_formats.ContentFormats second)Checks if first and second have any matching formats.gobject.types.GType matchGtype(gdk.content_formats.ContentFormats second)Finds the first `GType` from first that is also contained in second.string matchMimeType(gdk.content_formats.ContentFormats second)Finds the first mime type from first that is also contained in second.void print(glib.string_.String string_)Prints the given formats into a string for human consumption.string toString_()Prints the given formats into a human-readable string.gdk.content_formats.ContentFormats union_(gdk.content_formats.ContentFormats second)Append all missing types from second to first, in the order they had in second.gdk.content_formats.ContentFormats unionDeserializeGtypes()Add GTypes for mime types in formats for which deserializers are registered. Returns: a new [gdk.content_formats.ContentFormats]gdk.content_formats.ContentFormats unionDeserializeMimeTypes()Add mime types for GTypes in formats for which deserializers are registered. Returns: a new [gdk.content_formats.ContentFormats]gdk.content_formats.ContentFormats unionSerializeGtypes()Add GTypes for the mime types in formats for which serializers are registered. Returns: a new [gdk.content_formats.ContentFormats]gdk.content_formats.ContentFormats unionSerializeMimeTypes()Add mime types for GTypes in formats for which serializers are registered. Returns: a new [gdk.content_formats.ContentFormats]gdk.content_formats.ContentFormats parse(string string_)Parses the given string into [gdk.content_formats.ContentFormats] and returns the formats.