Github User Fetcher 1.0.0
C Application with Server and GUI
Loading...
Searching...
No Matches
gtkbuilderscope.h
Go to the documentation of this file.
1/*
2 * Copyright © 2019 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.1 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 * Authors: Benjamin Otte <otte@gnome.org>
18 */
19
20#pragma once
21
22#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
23#error "Only <gtk/gtk.h> can be included directly."
24#endif
25
26#include <gtk/gtktypes.h>
27
29
30#define GTK_TYPE_BUILDER_SCOPE (gtk_builder_scope_get_type ())
31
33G_DECLARE_INTERFACE (GtkBuilderScope, gtk_builder_scope, GTK, BUILDER_SCOPE, GObject)
34
35/**
36 * GtkBuilderClosureFlags:
37 * @GTK_BUILDER_CLOSURE_SWAPPED: The closure should be created swapped. See
38 * g_cclosure_new_swap() for details.
39 *
40 * The list of flags that can be passed to gtk_builder_create_closure().
41 *
42 * New values may be added in the future for new features, so external
43 * implementations of [iface@Gtk.BuilderScope] should test the flags
44 * for unknown values and raise a %GTK_BUILDER_ERROR_INVALID_ATTRIBUTE error
45 * when they encounter one.
46 */
47typedef enum { /*< prefix=GTK_BUILDER_CLOSURE >*/
50
51/**
52 * GtkBuilderScopeInterface:
53 * @get_type_from_name: Try to lookup a `GType` via the its name. See
54 * gtk_builder_get_type_from_name() for more details.
55 * The C implementation will use g_type_from_name() and if that fails try to guess the
56 * correct function name for registering the type and then use dlsym() to load it.
57 * The default implementation just tries g_type_from_name() and otherwise fails.
58 * @get_type_from_function: Try to lookup a `GType` via the given function name, specified
59 * explicitly in a GtkBuilder file, like via the "type-func" attribute in the `<object>` tag.
60 * This function is very rarely used.
61 * The C implementation will use dlsym() and call the resulting function as a `GTypeFunc`.
62 * The default implementation will fail and just return %G_TYPE_INVALID.
63 * @create_closure: Create a closure with the given arguments. See gtk_builder_create_closure()
64 * for more details on those.
65 * The C implementation will try to use dlsym() to locate the function name and then
66 * g_cclosure_new() to create a closure for the symbol.
67 * The default implementation just fails and returns %NULL.
68 *
69 * The virtual function table to implement for `GtkBuilderScope` implementations.
70 * Default implementations for each function do exist, but they usually just fail,
71 * so it is suggested that implementations implement all of them.
72 */
74{
75 /*< private >*/
77
78 /*< public >*/
80 GtkBuilder *builder,
81 const char *type_name);
83 GtkBuilder *builder,
84 const char *function_name);
85
86 GClosure * (* create_closure) (GtkBuilderScope *self,
87 GtkBuilder *builder,
88 const char *function_name,
90 GObject *object,
91 GError **error);
92};
93
94
95
100
101#define GTK_TYPE_BUILDER_CSCOPE (gtk_builder_cscope_get_type ())
102
104G_DECLARE_DERIVABLE_TYPE (GtkBuilderCScope, gtk_builder_cscope, GTK, BUILDER_CSCOPE, GObject)
105
109void gtk_builder_cscope_add_callback_symbol (GtkBuilderCScope *self,
110 const char *callback_name,
111 GCallback callback_symbol);
113void gtk_builder_cscope_add_callback_symbols (GtkBuilderCScope *self,
114 const char *first_callback_name,
115 GCallback first_callback_symbol,
117
118#define gtk_builder_cscope_add_callback(scope, callback) \
119 gtk_builder_cscope_add_callback_symbol (GTK_BUILDER_CSCOPE (scope), #callback, G_CALLBACK (callback))
120
123 const char *callback_name);
124
125
127
void(* GCallback)(void)
Definition gclosure.h:92
#define GDK_AVAILABLE_IN_ALL
#define G_END_DECLS
Definition gmacros.h:910
#define G_GNUC_NULL_TERMINATED
Definition gmacros.h:326
#define G_BEGIN_DECLS
Definition gmacros.h:909
GtkBuilderClosureFlags
@ GTK_BUILDER_CLOSURE_SWAPPED
GDK_AVAILABLE_IN_ALL void gtk_builder_cscope_add_callback_symbols(GtkBuilderCScope *self, const char *first_callback_name, GCallback first_callback_symbol,...) G_GNUC_NULL_TERMINATED
GDK_AVAILABLE_IN_ALL GDK_AVAILABLE_IN_ALL GtkBuilderScope * gtk_builder_cscope_new(void)
GDK_AVAILABLE_IN_ALL GCallback gtk_builder_cscope_lookup_callback_symbol(GtkBuilderCScope *self, const char *callback_name)
GDK_AVAILABLE_IN_ALL void gtk_builder_cscope_add_callback_symbol(GtkBuilderCScope *self, const char *callback_name, GCallback callback_symbol)
struct _GtkBuilder GtkBuilder
Definition gtktypes.h:38
struct _GtkBuilderScope GtkBuilderScope
Definition gtktypes.h:39
#define G_DECLARE_INTERFACE(ModuleObjName, module_obj_name, MODULE, OBJ_NAME, PrerequisiteName)
Definition gtype.h:1797
gsize GType
Definition gtype.h:427
#define G_DECLARE_DERIVABLE_TYPE(ModuleObjName, module_obj_name, MODULE, OBJ_NAME, ParentName)
Definition gtype.h:1705
static void error(LoadState *S, const char *why)
GType(* get_type_from_name)(GtkBuilderScope *self, GtkBuilder *builder, const char *type_name)
GType(* get_type_from_function)(GtkBuilderScope *self, GtkBuilder *builder, const char *function_name)