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

126 lines
7.0 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/>.
*/
Convert headers to #pragma once The conversion was done by guard2one.
2023-03-31 19:11:10 +00:00
#pragma once
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
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
Drop the gdk/gdkversionmacros.h header It was just added to avoid touching too many files. Touching them now.
2023-05-09 15:16:31 +00:00
#include <gdk/version/gdkversionmacros.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
#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
Reference in New Issue Copy Permalink