clipboard: Introduce GdkContentProvider

GdkContentProvider is the object that represents local data in the
clipboard.

This patch only introduces the object and adds the clipboard properties,
it does not yet provide a way for the actual implementations to access
it.

The only access that is implemented is the local shortcut GValue access.

1 files changed, 115 insertions, 0 deletions

diff --git a/gdk/gdkcontentprovider.h b/gdk/gdkcontentprovider.h
new file mode 100644
index 0000000000..90b9eae88b
--- /dev/null
+++ b/gdk/gdkcontentprovider.h
@@ -0,0 +1,115 @@
+/* GDK - The GIMP Drawing Kit
+ *
+ * Copyright (C) 2017 Benjamin Otte <otte@gnome.org>
+ *
+ * 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 __GDK_CONTENT_PROVIDER_H__
+#define __GDK_CONTENT_PROVIDER_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>
+#include <gio/gio.h>
+
+
+G_BEGIN_DECLS
+
+#define GDK_TYPE_CONTENT_PROVIDER            (gdk_content_provider_get_type ())
+#define GDK_CONTENT_PROVIDER(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GDK_TYPE_CONTENT_PROVIDER, GdkContentProvider))
+#define GDK_IS_CONTENT_PROVIDER(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GDK_TYPE_CONTENT_PROVIDER))
+#define GDK_CONTENT_PROVIDER_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_CONTENT_PROVIDER, GdkContentProviderClass))
+#define GDK_IS_CONTENT_PROVIDER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_CONTENT_PROVIDER))
+#define GDK_CONTENT_PROVIDER_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_CONTENT_PROVIDER, GdkContentProviderClass))
+
+typedef struct _GdkContentProviderClass GdkContentProviderClass;
+
+struct _GdkContentProvider
+{
+  GObject parent;
+};
+
+struct _GdkContentProviderClass
+{
+  GObjectClass parent_class;
+
+  /* signals */
+  void                  (* content_changed)                             (GdkContentProvider     *provider);
+
+  /* vfuncs */
+  void                  (* attach_clipboard)                            (GdkContentProvider     *provider,
+                                                                         GdkClipboard           *clipboard);
+  void                  (* detach_clipboard)                            (GdkContentProvider     *provider,
+                                                                         GdkClipboard           *clipboard);
+
+  GdkContentFormats *   (* ref_formats)                                 (GdkContentProvider     *provider);
+  void                  (* write_mime_type_async)                       (GdkContentProvider     *provider,
+                                                                         const char             *mime_type,
+                                                                         GOutputStream          *stream,
+                                                                         int                     io_priority,
+                                                                         GCancellable           *cancellable,
+                                                                         GAsyncReadyCallback     callback,
+                                                                         gpointer                user_data);
+  gboolean              (* write_mime_type_finish)                      (GdkContentProvider     *provider,
+                                                                         GAsyncResult           *result,
+                                                                         GError                **error);
+  gboolean              (* get_value)                                   (GdkContentProvider     *provider,
+                                                                         GValue                 *value,
+                                                                         GError                **error);
+
+  /*< private >*/
+  /* Padding for future expansion */
+  void (*_gdk_reserved1) (void);
+  void (*_gdk_reserved2) (void);
+  void (*_gdk_reserved3) (void);
+  void (*_gdk_reserved4) (void);
+  void (*_gdk_reserved5) (void);
+  void (*_gdk_reserved6) (void);
+  void (*_gdk_reserved7) (void);
+  void (*_gdk_reserved8) (void);
+};
+
+
+GDK_AVAILABLE_IN_3_94
+GType                   gdk_content_provider_get_type                   (void) G_GNUC_CONST;
+
+GDK_AVAILABLE_IN_3_94
+GdkContentFormats *     gdk_content_provider_ref_formats                (GdkContentProvider     *provider);
+
+GDK_AVAILABLE_IN_3_94
+void                    gdk_content_provider_content_changed            (GdkContentProvider     *provider);
+
+GDK_AVAILABLE_IN_3_94
+void                    gdk_content_provider_write_mime_type_async      (GdkContentProvider     *provider,
+                                                                         const char             *mime_type,
+                                                                         GOutputStream          *stream,
+                                                                         int                     io_priority,
+                                                                         GCancellable           *cancellable,
+                                                                         GAsyncReadyCallback     callback,
+                                                                         gpointer                user_data);
+GDK_AVAILABLE_IN_3_94
+gboolean                gdk_content_provider_write_mime_type_finish     (GdkContentProvider     *provider,
+                                                                         GAsyncResult           *result,
+                                                                         GError                **error);
+GDK_AVAILABLE_IN_3_94
+gboolean                gdk_content_provider_get_value                  (GdkContentProvider     *provider,
+                                                                         GValue                 *value,
+                                                                         GError                **error);
+G_END_DECLS
+
+#endif /* __GDK_CONTENT_PROVIDER_H__ */