class Gdk::ContentFormats
- Gdk::ContentFormats
- Reference
- Object
Overview
The GdkContentFormats
structure is used to advertise and negotiate the
format of content.
You will encounter GdkContentFormats
when interacting with objects
controlling operations that pass data between different widgets, window
or application, like Gdk#Drag
, Gdk#Drop
,
Gdk#Clipboard
or Gdk#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#ContentSerializer
and Gdk#ContentDeserializer
are used.
A GdkContentFormats
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::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::ContentFormats#to_string
exists. It will print a comma-separated list of formats from most important
to least important.
GdkContentFormats
is an immutable struct. After creation, you cannot change
the types it represents. Instead, new GdkContentFormats
have to be created.
The Gdk#ContentFormatsBuilder
structure is meant to help in this
endeavor.
Defined in:
auto/gdk-4.0/content_formats.crConstructors
- .new(pointer : Pointer(Void), transfer : GICrystal::Transfer)
- .new(mime_types : Enumerable(String)?)
- .new(*mime_types : String)
- .new_for_gtype(type : UInt64) : self
Class Method Summary
-
.g_type : UInt64
Returns the type id (GType) registered in GLib type system.
- .parse(string : String) : Gdk::ContentFormats?
Instance Method Summary
-
#==(other : self) : Bool
Returns
true
if this reference is the same as other. - #contain_gtype(type : UInt64) : Bool
- #contain_mime_type(mime_type : String) : Bool
- #finalize
- #gtypes : Enumerable(UInt64)?
- #match(second : Gdk::ContentFormats) : Bool
- #match_gtype(second : Gdk::ContentFormats) : UInt64
- #match_mime_type(second : Gdk::ContentFormats) : String?
- #mime_types : Enumerable(String)?
- #print(string : GLib::String) : Nil
- #ref : Gdk::ContentFormats
- #to_string : String
- #to_unsafe : Pointer(Void)
- #union(second : Gdk::ContentFormats) : Gdk::ContentFormats
- #union_deserialize_gtypes : Gdk::ContentFormats
- #union_deserialize_mime_types : Gdk::ContentFormats
- #union_serialize_gtypes : Gdk::ContentFormats
- #union_serialize_mime_types : Gdk::ContentFormats
- #unref : Nil
Constructor Detail
Class Method Detail
Instance Method Detail
Returns true
if this reference is the same as other. Invokes same?
.