1 | /* GTK - The GIMP Toolkit |
2 | * Copyright (C) 2017 Benjamin Otte |
3 | * |
4 | * This library is free software; you can redistribute it and/or |
5 | * modify it under the terms of the GNU Lesser General Public |
6 | * License as published by the Free Software Foundation; either |
7 | * version 2 of the License, or (at your option) any later version. |
8 | * |
9 | * This library is distributed in the hope that it will be useful, |
10 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
11 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
12 | * Lesser General Public License for more details. |
13 | * |
14 | * You should have received a copy of the GNU Lesser General Public |
15 | * License along with this library. If not, see <http://www.gnu.org/licenses/>. |
16 | */ |
17 | |
18 | #ifndef __GTK_CONTENT_DESERIALIZER_H__ |
19 | #define __GTK_CONTENT_DESERIALIZER_H__ |
20 | |
21 | #if !defined (__GDK_H_INSIDE__) && !defined (GTK_COMPILATION) |
22 | #error "Only <gdk/gdk.h> can be included directly." |
23 | #endif |
24 | |
25 | |
26 | #include <gdk/gdkversionmacros.h> |
27 | #include <gdk/gdktypes.h> |
28 | |
29 | G_BEGIN_DECLS |
30 | |
31 | #define GDK_TYPE_CONTENT_DESERIALIZER (gdk_content_deserializer_get_type ()) |
32 | #define GDK_CONTENT_DESERIALIZER(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GDK_TYPE_CONTENT_DESERIALIZER, GdkContentDeserializer)) |
33 | #define GDK_IS_CONTENT_DESERIALIZER(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GDK_TYPE_CONTENT_DESERIALIZER)) |
34 | |
35 | typedef struct _GdkContentDeserializer GdkContentDeserializer; |
36 | |
37 | /** |
38 | * GdkContentDeserializeFunc: |
39 | * @deserializer: a `GdkContentDeserializer` |
40 | * |
41 | * The type of a function that can be registered with gdk_content_register_deserializer(). |
42 | * |
43 | * When the function gets called to operate on content, it can call functions on the |
44 | * @deserializer object to obtain the mime type, input stream, user data, etc. for its |
45 | * operation. |
46 | */ |
47 | typedef void (* GdkContentDeserializeFunc) (GdkContentDeserializer *deserializer); |
48 | |
49 | GDK_AVAILABLE_IN_ALL |
50 | GType gdk_content_deserializer_get_type (void) G_GNUC_CONST; |
51 | |
52 | GDK_AVAILABLE_IN_ALL |
53 | const char * gdk_content_deserializer_get_mime_type (GdkContentDeserializer *deserializer); |
54 | GDK_AVAILABLE_IN_ALL |
55 | GType gdk_content_deserializer_get_gtype (GdkContentDeserializer *deserializer); |
56 | GDK_AVAILABLE_IN_ALL |
57 | GValue * gdk_content_deserializer_get_value (GdkContentDeserializer *deserializer); |
58 | GDK_AVAILABLE_IN_ALL |
59 | GInputStream * gdk_content_deserializer_get_input_stream (GdkContentDeserializer *deserializer); |
60 | GDK_AVAILABLE_IN_ALL |
61 | int gdk_content_deserializer_get_priority (GdkContentDeserializer *deserializer); |
62 | GDK_AVAILABLE_IN_ALL |
63 | GCancellable * gdk_content_deserializer_get_cancellable (GdkContentDeserializer *deserializer); |
64 | GDK_AVAILABLE_IN_ALL |
65 | gpointer gdk_content_deserializer_get_user_data (GdkContentDeserializer *deserializer); |
66 | GDK_AVAILABLE_IN_ALL |
67 | void gdk_content_deserializer_set_task_data (GdkContentDeserializer *deserializer, |
68 | gpointer data, |
69 | GDestroyNotify notify); |
70 | GDK_AVAILABLE_IN_ALL |
71 | gpointer gdk_content_deserializer_get_task_data (GdkContentDeserializer *deserializer); |
72 | |
73 | GDK_AVAILABLE_IN_ALL |
74 | void gdk_content_deserializer_return_success (GdkContentDeserializer *deserializer); |
75 | GDK_AVAILABLE_IN_ALL |
76 | void gdk_content_deserializer_return_error (GdkContentDeserializer *deserializer, |
77 | GError *error); |
78 | |
79 | GDK_AVAILABLE_IN_ALL |
80 | GdkContentFormats * gdk_content_formats_union_deserialize_gtypes (GdkContentFormats *formats); |
81 | GDK_AVAILABLE_IN_ALL |
82 | GdkContentFormats * gdk_content_formats_union_deserialize_mime_types(GdkContentFormats *formats); |
83 | |
84 | GDK_AVAILABLE_IN_ALL |
85 | void gdk_content_register_deserializer (const char *mime_type, |
86 | GType type, |
87 | GdkContentDeserializeFunc deserialize, |
88 | gpointer data, |
89 | GDestroyNotify notify); |
90 | GDK_AVAILABLE_IN_ALL |
91 | void gdk_content_deserialize_async (GInputStream *stream, |
92 | const char *mime_type, |
93 | GType type, |
94 | int io_priority, |
95 | GCancellable *cancellable, |
96 | GAsyncReadyCallback callback, |
97 | gpointer user_data); |
98 | GDK_AVAILABLE_IN_ALL |
99 | gboolean gdk_content_deserialize_finish (GAsyncResult *result, |
100 | GValue *value, |
101 | GError **error); |
102 | |
103 | |
104 | G_END_DECLS |
105 | |
106 | #endif /* __GDK_CONTENT_DESERIALIZER_H__ */ |
107 | |