/* * Copyright © 2019 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.1 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 . * * Authors: Benjamin Otte */ #ifndef __GTK_BUILDER_SCOPE_H__ #define __GTK_BUILDER_SCOPE_H__ #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) #error "Only can be included directly." #endif #include G_BEGIN_DECLS #define GTK_TYPE_BUILDER_SCOPE (gtk_builder_scope_get_type ()) GDK_AVAILABLE_IN_ALL G_DECLARE_INTERFACE (GtkBuilderScope, gtk_builder_scope, GTK, BUILDER_SCOPE, GObject) /** * GtkBuilderClosureFlags: * @GTK_BUILDER_CLOSURE_SWAPPED: The closure should be created swapped. See * g_cclosure_new_swap() for details. * * The list of flags that can be passed to gtk_builder_create_closure(). * * New values may be added in the future for new features, so external * implementations of [interface@Gtk.BuilderScope] should test the flags * for unknown values and raise a %GTK_BUILDER_ERROR_INVALID_ATTRIBUTE error * when they encounter one. */ typedef enum { /*< prefix=GTK_BUILDER_CLOSURE >*/ GTK_BUILDER_CLOSURE_SWAPPED = (1 << 0) } GtkBuilderClosureFlags; /** * GtkBuilderScopeInterface: * @get_type_from_name: Try to lookup a #GType via the its name. See * gtk_builder_get_type_from_name() for more details. * The C implementation will use g_type_from_name() and if that fails try to guess the * correct function name for registering the type and then use dlsym() to load it. * The default implementation just tries g_type_from_name() and otherwise fails. * @get_type_from_function: Try to lookup a #GType via the given function name, specified * explicitly in a GtkBuilder file, like via the "type-func" attribute in the "" tag. * This function is very rarely used. * The C implementation will use dlsym() and call the resulting function as a #GTypeFunc. * The default implementation will fail and just return %G_TYPE_INVALID. * @create_closure: Create a closure with the given arguments. See gtk_builder_create_closure() * for more details on those. * The C implementation will try to use dlsym() to locate the function name and then * g_cclosure_new() to create a closure for the symbol. * The default implementation just fails and returns %NULL. * * The virtual function table to implement for #GtkBuilderScope implementations. * Default implementations for each function do exist, but they usually just fail, * so it is suggested that implementations implement all of them. */ struct _GtkBuilderScopeInterface { /*< private >*/ GTypeInterface g_iface; /*< public >*/ 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); GClosure * (* create_closure) (GtkBuilderScope *self, GtkBuilder *builder, const char *function_name, GtkBuilderClosureFlags flags, GObject *object, GError **error); }; struct _GtkBuilderCScopeClass { GObjectClass parent_class; }; #define GTK_TYPE_BUILDER_CSCOPE (gtk_builder_cscope_get_type ()) GDK_AVAILABLE_IN_ALL G_DECLARE_DERIVABLE_TYPE (GtkBuilderCScope, gtk_builder_cscope, GTK, BUILDER_CSCOPE, GObject) GDK_AVAILABLE_IN_ALL GtkBuilderScope * gtk_builder_cscope_new (void); GDK_AVAILABLE_IN_ALL void gtk_builder_cscope_add_callback_symbol (GtkBuilderCScope *self, const char *callback_name, GCallback callback_symbol); 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 GCallback gtk_builder_cscope_lookup_callback_symbol(GtkBuilderCScope *self, const char *callback_name); G_END_DECLS #endif /* __GTK_BUILDER_SCOPE_H__ */