AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
abe5181b10
gtk2/gdk/gdkclipboard.h

128 lines
7.1 KiB
C
Raw Normal View History

gdk: A GdkClipboard API draft This commit adds a GdkClipboard object which is intended to replace GtkClipboard, eventually.
2014-05-29 03:55:53 +00:00
/* 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_CLIPBOARD_H__
#define __GDK_CLIPBOARD_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: A GdkClipboard API draft This commit adds a GdkClipboard object which is intended to replace GtkClipboard, eventually.
2014-05-29 03:55:53 +00:00
#error "Only <gdk/gdk.h> can be included directly."
#endif
#include <gdk/gdkversionmacros.h>
#include <gdk/gdktypes.h>
clipboard: Change image convenience APIs Don't use pixbufs anymore, use textures.
2017-12-02 13:38:57 +00:00
#include <gio/gio.h>
gdk: A GdkClipboard API draft This commit adds a GdkClipboard object which is intended to replace GtkClipboard, eventually.
2014-05-29 03:55:53 +00:00
G_BEGIN_DECLS
#define GDK_TYPE_CLIPBOARD (gdk_clipboard_get_type ())
#define GDK_CLIPBOARD(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GDK_TYPE_CLIPBOARD, GdkClipboard))
#define GDK_IS_CLIPBOARD(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GDK_TYPE_CLIPBOARD))
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: A GdkClipboard API draft This commit adds a GdkClipboard object which is intended to replace GtkClipboard, eventually.
2014-05-29 03:55:53 +00:00
GType gdk_clipboard_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
gdk: A GdkClipboard API draft This commit adds a GdkClipboard object which is intended to replace GtkClipboard, eventually.
2014-05-29 03:55:53 +00:00
GdkDisplay * gdk_clipboard_get_display (GdkClipboard *clipboard);
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: A GdkClipboard API draft This commit adds a GdkClipboard object which is intended to replace GtkClipboard, eventually.
2014-05-29 03:55:53 +00:00
GdkContentFormats * gdk_clipboard_get_formats (GdkClipboard *clipboard);
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
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.
2017-11-24 05:17:37 +00:00
gboolean gdk_clipboard_is_local (GdkClipboard *clipboard);
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
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.
2017-11-24 05:17:37 +00:00
GdkContentProvider * gdk_clipboard_get_content (GdkClipboard *clipboard);
gdk: A GdkClipboard API draft This commit adds a GdkClipboard object which is intended to replace GtkClipboard, eventually.
2014-05-29 03:55:53 +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
clipboard: Add infrastructure to store clipboards Clipboard managers will be so happy once the backends actually implement it!
2017-11-29 22:23:36 +00:00
void gdk_clipboard_store_async (GdkClipboard *clipboard,
int io_priority,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
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
clipboard: Add infrastructure to store clipboards Clipboard managers will be so happy once the backends actually implement it!
2017-11-29 22:23:36 +00:00
gboolean gdk_clipboard_store_finish (GdkClipboard *clipboard,
GAsyncResult *result,
GError **error);
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
clipboard: Refactor gdk_clipboard_read() to be async This allows us not just to pass any mime type to the read function, but it also makes it possible to pass multiple mime types and the clipboard can then try them in order until it finds a supported one. This is so far not implemented though.
2017-11-22 08:25:35 +00:00
void gdk_clipboard_read_async (GdkClipboard *clipboard,
const char **mime_types,
int io_priority,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
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
clipboard: Refactor gdk_clipboard_read() to be async This allows us not just to pass any mime type to the read function, but it also makes it possible to pass multiple mime types and the clipboard can then try them in order until it finds a supported one. This is so far not implemented though.
2017-11-22 08:25:35 +00:00
GInputStream * gdk_clipboard_read_finish (GdkClipboard *clipboard,
GAsyncResult *result,
gdk: Change some async clipboard api The pattern we generally follow is to put the async result right after the source object, in finish functions. Do this for gdk_clipboard_read_finish.
2019-04-02 11:37:54 +00:00
const char **out_mime_type,
clipboard: Refactor gdk_clipboard_read() to be async This allows us not just to pass any mime type to the read function, but it also makes it possible to pass multiple mime types and the clipboard can then try them in order until it finds a supported one. This is so far not implemented though.
2017-11-22 08:25:35 +00:00
GError **error);
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: Im[plement content deserializing Add infrastructure to do GInputStream => GType conversions. Use that to implement gdk_clipboard_read_value() which reads into GValues.
2017-11-22 09:44:30 +00:00
void gdk_clipboard_read_value_async (GdkClipboard *clipboard,
GType type,
int io_priority,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
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: Im[plement content deserializing Add infrastructure to do GInputStream => GType conversions. Use that to implement gdk_clipboard_read_value() which reads into GValues.
2017-11-22 09:44:30 +00:00
const GValue * gdk_clipboard_read_value_finish (GdkClipboard *clipboard,
gdk: Documentation improvements
2017-12-05 07:52:48 +00:00
GAsyncResult *result,
gdk: Im[plement content deserializing Add infrastructure to do GInputStream => GType conversions. Use that to implement gdk_clipboard_read_value() which reads into GValues.
2017-11-22 09:44:30 +00:00
GError **error);
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: Change some async clipboard api The pattern we generally follow is to put the async result right after the source object, in finish functions. Do this for gdk_clipboard_read_finish.
2019-04-02 11:37:54 +00:00
void gdk_clipboard_read_texture_async (GdkClipboard *clipboard,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
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: Change some async clipboard api The pattern we generally follow is to put the async result right after the source object, in finish functions. Do this for gdk_clipboard_read_finish.
2019-04-02 11:37:54 +00:00
GdkTexture * gdk_clipboard_read_texture_finish (GdkClipboard *clipboard,
GAsyncResult *result,
GError **error);
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
clipboard: Add gdk_clipboard_read_text_async() Also add deserializers for G_TYPE_STRING.
2017-11-22 13:19:02 +00:00
void gdk_clipboard_read_text_async (GdkClipboard *clipboard,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
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
clipboard: Add gdk_clipboard_read_text_async() Also add deserializers for G_TYPE_STRING.
2017-11-22 13:19:02 +00:00
char * gdk_clipboard_read_text_finish (GdkClipboard *clipboard,
gdk: Documentation improvements
2017-12-05 07:52:48 +00:00
GAsyncResult *result,
clipboard: Add gdk_clipboard_read_text_async() Also add deserializers for G_TYPE_STRING.
2017-11-22 13:19:02 +00:00
GError **error);
gdk: A GdkClipboard API draft This commit adds a GdkClipboard object which is intended to replace GtkClipboard, eventually.
2014-05-29 03:55:53 +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
clipboard: Allow claiming the clipboard to fail Also make clipboard_claim() a vfunc so backends can override it. Because the whole operation a vfunc, backends have the option of adding code before the actual claim is done and potentially even fail or do something after the successful claim.
2017-11-24 19:42:40 +00:00
gboolean gdk_clipboard_set_content (GdkClipboard *clipboard,
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.
2017-11-24 05:17:37 +00:00
GdkContentProvider *provider);
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
Revert "clipboard: Add gdk_clipboard_set()" This reverts commit dc50e0637ffa8bc7a369d00a5d8e7656d03c3781. This broke the build.
2017-12-05 07:09:54 +00:00
void gdk_clipboard_set (GdkClipboard *clipboard,
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
Revert "clipboard: Add gdk_clipboard_set()" This reverts commit dc50e0637ffa8bc7a369d00a5d8e7656d03c3781. This broke the build.
2017-12-05 07:09:54 +00:00
void gdk_clipboard_set_valist (GdkClipboard *clipboard,
GType type,
va_list args);
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
Revert "clipboard: Add gdk_clipboard_set()" This reverts commit dc50e0637ffa8bc7a369d00a5d8e7656d03c3781. This broke the build.
2017-12-05 07:09:54 +00:00
void gdk_clipboard_set_value (GdkClipboard *clipboard,
const GValue *value);
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
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.
2017-11-24 05:17:37 +00:00
void gdk_clipboard_set_text (GdkClipboard *clipboard,
const char *text);
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
clipboard: Change image convenience APIs Don't use pixbufs anymore, use textures.
2017-12-02 13:38:57 +00:00
void gdk_clipboard_set_texture (GdkClipboard *clipboard,
GdkTexture *texture);
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.
2017-11-24 05:17:37 +00:00
gdk: Dissolve gdk-autocleanup.h Move the autocleanup declarations into their respective headers. While we are at it, correct the autocleanup declaration for GdkEvent to use gdk_event_unref, not g_object_unref. Oops
2022-09-23 23:08:25 +00:00
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GdkClipboard, g_object_unref)
gdk: A GdkClipboard API draft This commit adds a GdkClipboard object which is intended to replace GtkClipboard, eventually.
2014-05-29 03:55:53 +00:00
G_END_DECLS
#endif /* __GDK_CLIPBOARD_H__ */
Reference in New Issue Copy Permalink