AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-12-27 22:20:24 +00:00
Code Issues Projects Releases Wiki Activity
d69fdaa04d
gtk/gdk/gdkcontentformats.h

134 lines
6.4 KiB
C
Raw Normal View History

gdk: Move GtkTargetList to GDK It's gonna be renamed next, so put it in the right source file already. For now retain the old name to keep the diff small.
2017-11-17 16:31:59 +00:00
/* GTK - The GIMP Toolkit
contentformats: Rename GtkTargetList It's now called GdkContentsFormat
2017-11-18 01:19:53 +00:00
* Copyright (C) 2017 Benjamin Otte
gdk: Move GtkTargetList to GDK It's gonna be renamed next, so put it in the right source file already. For now retain the old name to keep the diff small.
2017-11-17 16:31:59 +00:00
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef __GTK_CONTENT_FORMATS_H__
#define __GTK_CONTENT_FORMATS_H__
Use a single compilation symbol We use a compilation symbol in our build to allow the inclusion of specific headers while building GTK, to avoid the need to include only the global header. Each namespace has its own compilation symbol because we used to have different libraries, and strict symbol visibility between libraries; now that we have a single library, and we can use private symbols across namespaces while building GTK, we should have a single compilation symbol, and simplify the build rules.
2019-11-27 13:33:43 +00:00
#if !defined (__GDK_H_INSIDE__) && !defined (GTK_COMPILATION)
gdk: Move GtkTargetList to GDK It's gonna be renamed next, so put it in the right source file already. For now retain the old name to keep the diff small.
2017-11-17 16:31:59 +00:00
#error "Only <gdk/gdk.h> can be included directly."
#endif
#include <gdk/gdkversionmacros.h>
#include <gdk/gdktypes.h>
G_BEGIN_DECLS
contentformats: Rename GtkTargetList It's now called GdkContentsFormat
2017-11-18 01:19:53 +00:00
#define GDK_TYPE_CONTENT_FORMATS (gdk_content_formats_get_type ())
gdk: Move GtkTargetList to GDK It's gonna be renamed next, so put it in the right source file already. For now retain the old name to keep the diff small.
2017-11-17 16:31:59 +00:00
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
x11: Implement claiming the X Selection with the clipboard ... and of course support writing to other apps.
2017-11-25 20:59:39 +00:00
const char * gdk_intern_mime_type (const char *string);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
contentformats: Rename GtkTargetList It's now called GdkContentsFormat
2017-11-18 01:19:53 +00:00
GType gdk_content_formats_get_type (void) G_GNUC_CONST;
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
contentformats: Rename GtkTargetList It's now called GdkContentsFormat
2017-11-18 01:19:53 +00:00
GdkContentFormats * gdk_content_formats_new (const char **mime_types,
guint n_mime_types);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Add gdk_content_formats_new_for_gtype() Many places create formats for a single tpye, so make it easy for them to get this without having to create a builder first.
2017-11-28 01:02:06 +00:00
GdkContentFormats * gdk_content_formats_new_for_gtype (GType type);
contentformats: Add gdk_content_formats_parse()
2021-07-26 00:33:31 +00:00
GDK_AVAILABLE_IN_4_4
GdkContentFormats * gdk_content_formats_parse (const char *string);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
contentformats: Rename GtkTargetList It's now called GdkContentsFormat
2017-11-18 01:19:53 +00:00
GdkContentFormats * gdk_content_formats_ref (GdkContentFormats *formats);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
contentformats: Rename GtkTargetList It's now called GdkContentsFormat
2017-11-18 01:19:53 +00:00
void gdk_content_formats_unref (GdkContentFormats *formats);
gdk: Move GtkTargetList to GDK It's gonna be renamed next, so put it in the right source file already. For now retain the old name to keep the diff small.
2017-11-17 16:31:59 +00:00
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdkdnd: Make GdkDragContext->formats a GdkContentFormats Instead of it being a GList of GdkAtoms.
2017-11-18 04:53:25 +00:00
void gdk_content_formats_print (GdkContentFormats *formats,
GString *string);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdkdnd: Make GdkDragContext->formats a GdkContentFormats Instead of it being a GList of GdkAtoms.
2017-11-18 04:53:25 +00:00
char * gdk_content_formats_to_string (GdkContentFormats *formats);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
contentformats: Constify some functions
2020-03-02 02:39:14 +00:00
const GType * gdk_content_formats_get_gtypes (const GdkContentFormats *formats,
gdk: Add GType support to GdkContentFormats This is not used by anything yet, but add it now, so people looking at this new code can make sense of it. Plus, the documentation mentions it, so better have the docs make sense. It will be used once we add support for conversions to GDK and allow doing cipboard/dnd by GValue.
2017-11-20 14:58:17 +00:00
gsize *n_gtypes);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
contentformats: Constify some functions
2020-03-02 02:39:14 +00:00
const char * const * gdk_content_formats_get_mime_types (const GdkContentFormats *formats,
gdk: Sanitize GdkContentFormats API Make sure the API reflects the idea that GdkContentFormats is a set containing mime types. In particular, treat the object itself as a plural - it's named content format`S' after all - and therefor use the correct verb form. Also make GdkContentFormats keep an array instead of a list, now that it's immutable.
2017-11-20 03:42:43 +00:00
gsize *n_mime_types);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Make GdkContentFormats immutable
2017-11-20 02:54:42 +00:00
GdkContentFormats * gdk_content_formats_union (GdkContentFormats *first,
const GdkContentFormats *second) G_GNUC_WARN_UNUSED_RESULT;
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Add GType support to GdkContentFormats This is not used by anything yet, but add it now, so people looking at this new code can make sense of it. Plus, the documentation mentions it, so better have the docs make sense. It will be used once we add support for conversions to GDK and allow doing cipboard/dnd by GValue.
2017-11-20 14:58:17 +00:00
gboolean gdk_content_formats_match (const GdkContentFormats *first,
gdkcontentformats: Change the matching API Instead of having just one function that has the gtype and mime type as out arguments, have 3 functions: 1 that finds any match, 1 that finds a GType match and one for a mime type match. This makes the API way more convenient to use.
2017-11-24 10:34:19 +00:00
const GdkContentFormats *second);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdkcontentformats: Change the matching API Instead of having just one function that has the gtype and mime type as out arguments, have 3 functions: 1 that finds any match, 1 that finds a GType match and one for a mime type match. This makes the API way more convenient to use.
2017-11-24 10:34:19 +00:00
GType gdk_content_formats_match_gtype (const GdkContentFormats *first,
const GdkContentFormats *second);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdkcontentformats: Change the matching API Instead of having just one function that has the gtype and mime type as out arguments, have 3 functions: 1 that finds any match, 1 that finds a GType match and one for a mime type match. This makes the API way more convenient to use.
2017-11-24 10:34:19 +00:00
const char * gdk_content_formats_match_mime_type (const GdkContentFormats *first,
const GdkContentFormats *second);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Add GType support to GdkContentFormats This is not used by anything yet, but add it now, so people looking at this new code can make sense of it. Plus, the documentation mentions it, so better have the docs make sense. It will be used once we add support for conversions to GDK and allow doing cipboard/dnd by GValue.
2017-11-20 14:58:17 +00:00
gboolean gdk_content_formats_contain_gtype (const GdkContentFormats *formats,
GType type);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Sanitize GdkContentFormats API Make sure the API reflects the idea that GdkContentFormats is a set containing mime types. In particular, treat the object itself as a plural - it's named content format`S' after all - and therefor use the correct verb form. Also make GdkContentFormats keep an array instead of a list, now that it's immutable.
2017-11-20 03:42:43 +00:00
gboolean gdk_content_formats_contain_mime_type (const GdkContentFormats *formats,
contentformats: Rename GtkTargetList It's now called GdkContentsFormat
2017-11-18 01:19:53 +00:00
const char *mime_type);
gdk: Move GtkTargetList to GDK It's gonna be renamed next, so put it in the right source file already. For now retain the old name to keep the diff small.
2017-11-17 16:31:59 +00:00
Allow binding GdkContentFormatsBuilder GdkContentFormatsBuilder is currently not introspectable, as it does not have a GType. We can turn it into a boxed type, but we need to implement memory management for it. The current gdk_content_formats_builder_free() function returns a newly constructed value, so we cannot use it as a GBoxedFreeFunc; additionally copying a GdkContentFormatsBuilder contents would make it a bit odd, as you could get multiple identical GdkContentFormats out of the copies. A simple approach is to model the GdkContentFormatsBuilder API to follow the GBytes one: use reference counting for memory management, and have a function to release a reference, return a GdkContentFormats, and reset the GdkContentFormatsBuilder state. For language bindings, we can provide a get_formats() function that returns the GdkContentFormats instance and resets the builder instance, leaving the reference count untouched. For C convenience we can keep gdk_content_formats_builder_free(), and make it a wrapper around gdk_content_formats_builder_get_formats(), with the guarantee that it'll free the builder instance regardless of its current reference count. https://bugzilla.gnome.org/show_bug.cgi?id=793097 https://blogs.gnome.org/otte/2018/02/03/builders/
2018-02-01 16:43:15 +00:00
#define GDK_TYPE_CONTENT_FORMATS_BUILDER (gdk_content_formats_builder_get_type ())
gdk: Add GdkContentFormatsBuilder Yes, the name is too long. No, I couldn't think of a shorter one.
2017-11-20 01:47:45 +00:00
typedef struct _GdkContentFormatsBuilder GdkContentFormatsBuilder;
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Allow binding GdkContentFormatsBuilder GdkContentFormatsBuilder is currently not introspectable, as it does not have a GType. We can turn it into a boxed type, but we need to implement memory management for it. The current gdk_content_formats_builder_free() function returns a newly constructed value, so we cannot use it as a GBoxedFreeFunc; additionally copying a GdkContentFormatsBuilder contents would make it a bit odd, as you could get multiple identical GdkContentFormats out of the copies. A simple approach is to model the GdkContentFormatsBuilder API to follow the GBytes one: use reference counting for memory management, and have a function to release a reference, return a GdkContentFormats, and reset the GdkContentFormatsBuilder state. For language bindings, we can provide a get_formats() function that returns the GdkContentFormats instance and resets the builder instance, leaving the reference count untouched. For C convenience we can keep gdk_content_formats_builder_free(), and make it a wrapper around gdk_content_formats_builder_get_formats(), with the guarantee that it'll free the builder instance regardless of its current reference count. https://bugzilla.gnome.org/show_bug.cgi?id=793097 https://blogs.gnome.org/otte/2018/02/03/builders/
2018-02-01 16:43:15 +00:00
GType gdk_content_formats_builder_get_type (void) G_GNUC_CONST;
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Allow binding GdkContentFormatsBuilder GdkContentFormatsBuilder is currently not introspectable, as it does not have a GType. We can turn it into a boxed type, but we need to implement memory management for it. The current gdk_content_formats_builder_free() function returns a newly constructed value, so we cannot use it as a GBoxedFreeFunc; additionally copying a GdkContentFormatsBuilder contents would make it a bit odd, as you could get multiple identical GdkContentFormats out of the copies. A simple approach is to model the GdkContentFormatsBuilder API to follow the GBytes one: use reference counting for memory management, and have a function to release a reference, return a GdkContentFormats, and reset the GdkContentFormatsBuilder state. For language bindings, we can provide a get_formats() function that returns the GdkContentFormats instance and resets the builder instance, leaving the reference count untouched. For C convenience we can keep gdk_content_formats_builder_free(), and make it a wrapper around gdk_content_formats_builder_get_formats(), with the guarantee that it'll free the builder instance regardless of its current reference count. https://bugzilla.gnome.org/show_bug.cgi?id=793097 https://blogs.gnome.org/otte/2018/02/03/builders/
2018-02-01 16:43:15 +00:00
GdkContentFormatsBuilder *gdk_content_formats_builder_new (void);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Allow binding GdkContentFormatsBuilder GdkContentFormatsBuilder is currently not introspectable, as it does not have a GType. We can turn it into a boxed type, but we need to implement memory management for it. The current gdk_content_formats_builder_free() function returns a newly constructed value, so we cannot use it as a GBoxedFreeFunc; additionally copying a GdkContentFormatsBuilder contents would make it a bit odd, as you could get multiple identical GdkContentFormats out of the copies. A simple approach is to model the GdkContentFormatsBuilder API to follow the GBytes one: use reference counting for memory management, and have a function to release a reference, return a GdkContentFormats, and reset the GdkContentFormatsBuilder state. For language bindings, we can provide a get_formats() function that returns the GdkContentFormats instance and resets the builder instance, leaving the reference count untouched. For C convenience we can keep gdk_content_formats_builder_free(), and make it a wrapper around gdk_content_formats_builder_get_formats(), with the guarantee that it'll free the builder instance regardless of its current reference count. https://bugzilla.gnome.org/show_bug.cgi?id=793097 https://blogs.gnome.org/otte/2018/02/03/builders/
2018-02-01 16:43:15 +00:00
GdkContentFormatsBuilder *gdk_content_formats_builder_ref (GdkContentFormatsBuilder *builder);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Allow binding GdkContentFormatsBuilder GdkContentFormatsBuilder is currently not introspectable, as it does not have a GType. We can turn it into a boxed type, but we need to implement memory management for it. The current gdk_content_formats_builder_free() function returns a newly constructed value, so we cannot use it as a GBoxedFreeFunc; additionally copying a GdkContentFormatsBuilder contents would make it a bit odd, as you could get multiple identical GdkContentFormats out of the copies. A simple approach is to model the GdkContentFormatsBuilder API to follow the GBytes one: use reference counting for memory management, and have a function to release a reference, return a GdkContentFormats, and reset the GdkContentFormatsBuilder state. For language bindings, we can provide a get_formats() function that returns the GdkContentFormats instance and resets the builder instance, leaving the reference count untouched. For C convenience we can keep gdk_content_formats_builder_free(), and make it a wrapper around gdk_content_formats_builder_get_formats(), with the guarantee that it'll free the builder instance regardless of its current reference count. https://bugzilla.gnome.org/show_bug.cgi?id=793097 https://blogs.gnome.org/otte/2018/02/03/builders/
2018-02-01 16:43:15 +00:00
void gdk_content_formats_builder_unref (GdkContentFormatsBuilder *builder);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Allow binding GdkContentFormatsBuilder GdkContentFormatsBuilder is currently not introspectable, as it does not have a GType. We can turn it into a boxed type, but we need to implement memory management for it. The current gdk_content_formats_builder_free() function returns a newly constructed value, so we cannot use it as a GBoxedFreeFunc; additionally copying a GdkContentFormatsBuilder contents would make it a bit odd, as you could get multiple identical GdkContentFormats out of the copies. A simple approach is to model the GdkContentFormatsBuilder API to follow the GBytes one: use reference counting for memory management, and have a function to release a reference, return a GdkContentFormats, and reset the GdkContentFormatsBuilder state. For language bindings, we can provide a get_formats() function that returns the GdkContentFormats instance and resets the builder instance, leaving the reference count untouched. For C convenience we can keep gdk_content_formats_builder_free(), and make it a wrapper around gdk_content_formats_builder_get_formats(), with the guarantee that it'll free the builder instance regardless of its current reference count. https://bugzilla.gnome.org/show_bug.cgi?id=793097 https://blogs.gnome.org/otte/2018/02/03/builders/
2018-02-01 16:43:15 +00:00
GdkContentFormats * gdk_content_formats_builder_free_to_formats (GdkContentFormatsBuilder *builder) G_GNUC_WARN_UNUSED_RESULT;
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Allow binding GdkContentFormatsBuilder GdkContentFormatsBuilder is currently not introspectable, as it does not have a GType. We can turn it into a boxed type, but we need to implement memory management for it. The current gdk_content_formats_builder_free() function returns a newly constructed value, so we cannot use it as a GBoxedFreeFunc; additionally copying a GdkContentFormatsBuilder contents would make it a bit odd, as you could get multiple identical GdkContentFormats out of the copies. A simple approach is to model the GdkContentFormatsBuilder API to follow the GBytes one: use reference counting for memory management, and have a function to release a reference, return a GdkContentFormats, and reset the GdkContentFormatsBuilder state. For language bindings, we can provide a get_formats() function that returns the GdkContentFormats instance and resets the builder instance, leaving the reference count untouched. For C convenience we can keep gdk_content_formats_builder_free(), and make it a wrapper around gdk_content_formats_builder_get_formats(), with the guarantee that it'll free the builder instance regardless of its current reference count. https://bugzilla.gnome.org/show_bug.cgi?id=793097 https://blogs.gnome.org/otte/2018/02/03/builders/
2018-02-01 16:43:15 +00:00
GdkContentFormats * gdk_content_formats_builder_to_formats (GdkContentFormatsBuilder *builder) G_GNUC_WARN_UNUSED_RESULT;
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Add GdkContentFormatsBuilder Yes, the name is too long. No, I couldn't think of a shorter one.
2017-11-20 01:47:45 +00:00
void gdk_content_formats_builder_add_formats (GdkContentFormatsBuilder *builder,
gdk: Make GdkContentFormats immutable
2017-11-20 02:54:42 +00:00
const GdkContentFormats *formats);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Add GdkContentFormatsBuilder Yes, the name is too long. No, I couldn't think of a shorter one.
2017-11-20 01:47:45 +00:00
void gdk_content_formats_builder_add_mime_type(GdkContentFormatsBuilder *builder,
const char *mime_type);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Add GType support to GdkContentFormats This is not used by anything yet, but add it now, so people looking at this new code can make sense of it. Plus, the documentation mentions it, so better have the docs make sense. It will be used once we add support for conversions to GDK and allow doing cipboard/dnd by GValue.
2017-11-20 14:58:17 +00:00
void gdk_content_formats_builder_add_gtype (GdkContentFormatsBuilder *builder,
GType type);
gdk: Add GdkContentFormatsBuilder Yes, the name is too long. No, I couldn't think of a shorter one.
2017-11-20 01:47:45 +00:00
gdk: Add GDK_TYPE_FILE_LIST with serializers This is a GSList of GFile and we want it so we can operate with lists of files and text/uri-list. I chose GSList over GList because that's what the GtkFileChooser API uses, too.
2017-11-29 08:37:50 +00:00
/* dunno where else to put this */
#define GDK_TYPE_FILE_LIST (gdk_file_list_get_type ())
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add getter to GdkFileList Language bindings don't really have any mean of accessing the list of files for GdkFileList.
2021-10-08 10:41:56 +00:00
GType gdk_file_list_get_type (void) G_GNUC_CONST;
gdk: Add GDK_TYPE_FILE_LIST with serializers This is a GSList of GFile and we want it so we can operate with lists of files and text/uri-list. I chose GSList over GList because that's what the GtkFileChooser API uses, too.
2017-11-29 08:37:50 +00:00
Add getter to GdkFileList Language bindings don't really have any mean of accessing the list of files for GdkFileList.
2021-10-08 10:41:56 +00:00
/**
* GdkFileList:
*
* An opaque type representing a list of files.
*
* Since: 4.6
*/
typedef struct _GdkFileList GdkFileList;
GDK_AVAILABLE_IN_4_6
GSList * gdk_file_list_get_files (GdkFileList *file_list);
Add constructors for GdkFileList C API users can keep dealing with the implicit equivalence of GdkFileList and GSList, but language bindings have no idea that one type is another, and none of them exposes GSList as a type anyway, so they will need a way to construct a GdkFileList. Instead of making GdkFileList mutable, and re-implement GSList, we only provide a constructors pair that lets you create a GdkFileList from a linked list or from an array.
2022-07-28 09:13:17 +00:00
GDK_AVAILABLE_IN_4_8
GdkFileList * gdk_file_list_new_from_list (GSList *files);
GDK_AVAILABLE_IN_4_8
GdkFileList * gdk_file_list_new_from_array (GFile **files,
gsize n_files);
gdk: Add GDK_TYPE_FILE_LIST with serializers This is a GSList of GFile and we want it so we can operate with lists of files and text/uri-list. I chose GSList over GList because that's what the GtkFileChooser API uses, too.
2017-11-29 08:37:50 +00:00
gdk: Move GtkTargetList to GDK It's gonna be renamed next, so put it in the right source file already. For now retain the old name to keep the diff small.
2017-11-17 16:31:59 +00:00
G_END_DECLS
#endif /* __GTK_CONTENT_FORMATS_H__ */
Reference in New Issue Copy Permalink