forked from AuroraMiddleware/gtk
2cbe094b91
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/
116 lines
5.9 KiB
C
116 lines
5.9 KiB
C
/* GTK - The GIMP Toolkit
|
|
* Copyright (C) 2017 Benjamin Otte
|
|
*
|
|
* 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__
|
|
|
|
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
|
|
#error "Only <gdk/gdk.h> can be included directly."
|
|
#endif
|
|
|
|
|
|
#include <gdk/gdkversionmacros.h>
|
|
#include <gdk/gdktypes.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GDK_TYPE_CONTENT_FORMATS (gdk_content_formats_get_type ())
|
|
|
|
GDK_AVAILABLE_IN_3_94
|
|
const char * gdk_intern_mime_type (const char *string);
|
|
|
|
GDK_AVAILABLE_IN_3_94
|
|
GType gdk_content_formats_get_type (void) G_GNUC_CONST;
|
|
GDK_AVAILABLE_IN_3_94
|
|
GdkContentFormats * gdk_content_formats_new (const char **mime_types,
|
|
guint n_mime_types);
|
|
GDK_AVAILABLE_IN_3_94
|
|
GdkContentFormats * gdk_content_formats_new_for_gtype (GType type);
|
|
GDK_AVAILABLE_IN_3_94
|
|
GdkContentFormats * gdk_content_formats_ref (GdkContentFormats *formats);
|
|
GDK_AVAILABLE_IN_3_94
|
|
void gdk_content_formats_unref (GdkContentFormats *formats);
|
|
|
|
GDK_AVAILABLE_IN_3_94
|
|
void gdk_content_formats_print (GdkContentFormats *formats,
|
|
GString *string);
|
|
GDK_AVAILABLE_IN_3_94
|
|
char * gdk_content_formats_to_string (GdkContentFormats *formats);
|
|
|
|
GDK_AVAILABLE_IN_3_94
|
|
const GType * gdk_content_formats_get_gtypes (GdkContentFormats *formats,
|
|
gsize *n_gtypes);
|
|
GDK_AVAILABLE_IN_3_94
|
|
const char * const * gdk_content_formats_get_mime_types (GdkContentFormats *formats,
|
|
gsize *n_mime_types);
|
|
|
|
GDK_AVAILABLE_IN_3_94
|
|
GdkContentFormats * gdk_content_formats_union (GdkContentFormats *first,
|
|
const GdkContentFormats *second) G_GNUC_WARN_UNUSED_RESULT;
|
|
GDK_AVAILABLE_IN_3_94
|
|
gboolean gdk_content_formats_match (const GdkContentFormats *first,
|
|
const GdkContentFormats *second);
|
|
GDK_AVAILABLE_IN_3_94
|
|
GType gdk_content_formats_match_gtype (const GdkContentFormats *first,
|
|
const GdkContentFormats *second);
|
|
GDK_AVAILABLE_IN_3_94
|
|
const char * gdk_content_formats_match_mime_type (const GdkContentFormats *first,
|
|
const GdkContentFormats *second);
|
|
GDK_AVAILABLE_IN_3_94
|
|
gboolean gdk_content_formats_contain_gtype (const GdkContentFormats *formats,
|
|
GType type);
|
|
GDK_AVAILABLE_IN_3_94
|
|
gboolean gdk_content_formats_contain_mime_type (const GdkContentFormats *formats,
|
|
const char *mime_type);
|
|
|
|
#define GDK_TYPE_CONTENT_FORMATS_BUILDER (gdk_content_formats_builder_get_type ())
|
|
|
|
typedef struct _GdkContentFormatsBuilder GdkContentFormatsBuilder;
|
|
|
|
GDK_AVAILABLE_IN_3_94
|
|
GType gdk_content_formats_builder_get_type (void) G_GNUC_CONST;
|
|
|
|
GDK_AVAILABLE_IN_3_94
|
|
GdkContentFormatsBuilder *gdk_content_formats_builder_new (void);
|
|
GDK_AVAILABLE_IN_3_94
|
|
GdkContentFormatsBuilder *gdk_content_formats_builder_ref (GdkContentFormatsBuilder *builder);
|
|
GDK_AVAILABLE_IN_3_94
|
|
void gdk_content_formats_builder_unref (GdkContentFormatsBuilder *builder);
|
|
GDK_AVAILABLE_IN_3_94
|
|
GdkContentFormats * gdk_content_formats_builder_free_to_formats (GdkContentFormatsBuilder *builder) G_GNUC_WARN_UNUSED_RESULT;
|
|
GDK_AVAILABLE_IN_3_94
|
|
GdkContentFormats * gdk_content_formats_builder_to_formats (GdkContentFormatsBuilder *builder) G_GNUC_WARN_UNUSED_RESULT;
|
|
GDK_AVAILABLE_IN_3_94
|
|
void gdk_content_formats_builder_add_formats (GdkContentFormatsBuilder *builder,
|
|
const GdkContentFormats *formats);
|
|
GDK_AVAILABLE_IN_3_94
|
|
void gdk_content_formats_builder_add_mime_type(GdkContentFormatsBuilder *builder,
|
|
const char *mime_type);
|
|
GDK_AVAILABLE_IN_3_94
|
|
void gdk_content_formats_builder_add_gtype (GdkContentFormatsBuilder *builder,
|
|
GType type);
|
|
|
|
/* dunno where else to put this */
|
|
#define GDK_TYPE_FILE_LIST (gdk_file_list_get_type ())
|
|
GDK_AVAILABLE_IN_3_94
|
|
GType gdk_file_list_get_type (void) G_GNUC_CONST;
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GTK_CONTENT_FORMATS_H__ */
|