Gtk.BuilderCScope¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`new` ()
	`add_callback_symbol` (callback_name, callback_symbol)

Virtual Methods¶

Inherited:: GObject.Object (7), Gtk.BuilderScope (3)

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Gtk.BuilderCScope(**kwargs)¶

Bases:: GObject.Object, Gtk.BuilderScope
Abstract:: No
Structure:: Gtk.BuilderCScopeClass

A GtkBuilderScope implementation for the C language.

GtkBuilderCScope instances use symbols explicitly added to builder with prior calls to [method`Gtk`.BuilderCScope.add_callback_symbol]. If developers want to do that, they are encouraged to create their own scopes for that purpose.

In the case that symbols are not explicitly added; GTK will uses GModule’s introspective features (by opening the module None) to look at the application’s symbol table. From here it tries to match the signal function names given in the interface description with symbols in the application.

Note that unless [method`Gtk`.BuilderCScope.add_callback_symbol] is called for all signal callbacks which are referenced by the loaded XML, this functionality will require that GModule be supported on the platform.

classmethod new()[source]¶

Returns:: a new GtkBuilderCScope
Return type:: Gtk.BuilderCScope

Creates a new GtkBuilderCScope object to use with future GtkBuilder instances.

Calling this function is only necessary if you want to add custom callbacks via [method`Gtk`.BuilderCScope.add_callback_symbol].

add_callback_symbol(callback_name, callback_symbol)[source]¶

Parameters:

callback_name (str) – The name of the callback, as expected in the XML
callback_symbol (GObject.Callback) – The callback pointer

Adds the callback_symbol to the scope of builder under the given callback_name.

Using this function overrides the behavior of [method`Gtk`.Builder.create_closure] for any callback symbols that are added. Using this method allows for better encapsulation as it does not require that callback symbols be declared in the global namespace.