gdkcontentdeserializer.h 5.6 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/* 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_DESERIALIZER_H__
#define __GTK_CONTENT_DESERIALIZER_H__

21
#if !defined (__GDK_H_INSIDE__) && !defined (GTK_COMPILATION)
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
#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_DESERIALIZER         (gdk_content_deserializer_get_type ())
#define GDK_CONTENT_DESERIALIZER(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), GDK_TYPE_CONTENT_DESERIALIZER, GdkContentDeserializer))
#define GDK_IS_CONTENT_DESERIALIZER(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), GDK_TYPE_CONTENT_DESERIALIZER))

typedef struct _GdkContentDeserializer GdkContentDeserializer;

37
38
/**
 * GdkContentDeserializeFunc:
Matthias Clasen's avatar
Matthias Clasen committed
39
 * @deserializer: a `GdkContentDeserializer`
40
41
 *
 * The type of a function that can be registered with gdk_content_register_deserializer().
Matthias Clasen's avatar
Matthias Clasen committed
42
 *
43
44
45
46
 * When the function gets called to operate on content, it can call functions on the
 * @deserializer object to obtain the mime type, input stream, user data, etc. for its
 * operation.
 */
47
48
typedef void (* GdkContentDeserializeFunc) (GdkContentDeserializer *deserializer);

Matthias Clasen's avatar
Matthias Clasen committed
49
GDK_AVAILABLE_IN_ALL
50
51
GType                   gdk_content_deserializer_get_type               (void) G_GNUC_CONST;

Matthias Clasen's avatar
Matthias Clasen committed
52
GDK_AVAILABLE_IN_ALL
53
const char *            gdk_content_deserializer_get_mime_type          (GdkContentDeserializer *deserializer);
Matthias Clasen's avatar
Matthias Clasen committed
54
GDK_AVAILABLE_IN_ALL
55
GType                   gdk_content_deserializer_get_gtype              (GdkContentDeserializer *deserializer);
Matthias Clasen's avatar
Matthias Clasen committed
56
GDK_AVAILABLE_IN_ALL
57
GValue *                gdk_content_deserializer_get_value              (GdkContentDeserializer *deserializer);
Matthias Clasen's avatar
Matthias Clasen committed
58
GDK_AVAILABLE_IN_ALL
59
GInputStream *          gdk_content_deserializer_get_input_stream       (GdkContentDeserializer *deserializer);
Matthias Clasen's avatar
Matthias Clasen committed
60
GDK_AVAILABLE_IN_ALL
61
int                     gdk_content_deserializer_get_priority           (GdkContentDeserializer *deserializer);
Matthias Clasen's avatar
Matthias Clasen committed
62
GDK_AVAILABLE_IN_ALL
63
GCancellable *          gdk_content_deserializer_get_cancellable        (GdkContentDeserializer *deserializer);
Matthias Clasen's avatar
Matthias Clasen committed
64
GDK_AVAILABLE_IN_ALL
65
gpointer                gdk_content_deserializer_get_user_data          (GdkContentDeserializer *deserializer);
Matthias Clasen's avatar
Matthias Clasen committed
66
GDK_AVAILABLE_IN_ALL
67
68
69
void                    gdk_content_deserializer_set_task_data          (GdkContentDeserializer *deserializer,
                                                                         gpointer                data,
                                                                         GDestroyNotify          notify);
Matthias Clasen's avatar
Matthias Clasen committed
70
GDK_AVAILABLE_IN_ALL
71
gpointer                gdk_content_deserializer_get_task_data          (GdkContentDeserializer *deserializer);
72

Matthias Clasen's avatar
Matthias Clasen committed
73
GDK_AVAILABLE_IN_ALL
74
void                    gdk_content_deserializer_return_success         (GdkContentDeserializer *deserializer);
Matthias Clasen's avatar
Matthias Clasen committed
75
GDK_AVAILABLE_IN_ALL
76
77
78
void                    gdk_content_deserializer_return_error           (GdkContentDeserializer *deserializer,
                                                                         GError                 *error);

Matthias Clasen's avatar
Matthias Clasen committed
79
GDK_AVAILABLE_IN_ALL
80
GdkContentFormats *     gdk_content_formats_union_deserialize_gtypes    (GdkContentFormats      *formats);
Matthias Clasen's avatar
Matthias Clasen committed
81
GDK_AVAILABLE_IN_ALL
82
83
GdkContentFormats *     gdk_content_formats_union_deserialize_mime_types(GdkContentFormats      *formats);

Matthias Clasen's avatar
Matthias Clasen committed
84
GDK_AVAILABLE_IN_ALL
85
86
87
88
89
void                    gdk_content_register_deserializer               (const char             *mime_type,
                                                                         GType                   type,
                                                                         GdkContentDeserializeFunc deserialize,
                                                                         gpointer                data,
                                                                         GDestroyNotify          notify);
Matthias Clasen's avatar
Matthias Clasen committed
90
GDK_AVAILABLE_IN_ALL
91
92
93
94
95
96
97
void                    gdk_content_deserialize_async                   (GInputStream           *stream,
                                                                         const char             *mime_type,
                                                                         GType                   type,
                                                                         int                     io_priority,
                                                                         GCancellable           *cancellable,
                                                                         GAsyncReadyCallback     callback,
                                                                         gpointer                user_data);
Matthias Clasen's avatar
Matthias Clasen committed
98
GDK_AVAILABLE_IN_ALL
99
100
gboolean                gdk_content_deserialize_finish                  (GAsyncResult           *result,
                                                                         GValue                 *value,
101
102
103
104
105
106
                                                                         GError                **error);


G_END_DECLS

#endif /* __GDK_CONTENT_DESERIALIZER_H__ */