Blame docs/reference/gtk/html/GtkBuilder.html

Packit Service fb6fa5
Packit Service fb6fa5
<html>
Packit Service fb6fa5
<head>
Packit Service fb6fa5
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit Service fb6fa5
<title>GtkBuilder: GTK+ 2 Reference Manual</title>
Packit Service fb6fa5
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit Service fb6fa5
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
Packit Service fb6fa5
<link rel="up" href="Builder.html" title="Interface builder">
Packit Service fb6fa5
<link rel="prev" href="GtkBuildable.html" title="GtkBuildable">
Packit Service fb6fa5
<link rel="next" href="DeprecatedObjects.html" title="Deprecated">
Packit Service fb6fa5
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
Packit Service fb6fa5
<link rel="stylesheet" href="style.css" type="text/css">
Packit Service fb6fa5
</head>
Packit Service fb6fa5
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Top  | 
Packit Service fb6fa5
                  Description  | 
Packit Service fb6fa5
                  Object Hierarchy  | 
Packit Service fb6fa5
                  Properties
Packit Service fb6fa5
Packit Service fb6fa5
Home
Packit Service fb6fa5
Up
Packit Service fb6fa5
Prev
Packit Service fb6fa5
Next
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GtkBuilder

Packit Service fb6fa5

GtkBuilder

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Functions

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
(*GtkBuilderConnectFunc) ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GtkBuilder *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_new ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
guint
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_add_from_file ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
guint
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_add_from_string ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
guint
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_add_objects_from_file ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
guint
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_add_objects_from_string ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GObject *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_get_object ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GSList *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_get_objects ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_connect_signals ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_connect_signals_full ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_set_translation_domain ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
const gchar *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_get_translation_domain ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GType
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_get_type_from_name ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gboolean
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_value_from_string ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gboolean
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_builder_value_from_string_type ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
#define
Packit Service fb6fa5
Packit Service fb6fa5
GTK_BUILDER_WARN_INVALID_CHILD_TYPE()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Properties

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gchar *
Packit Service fb6fa5
translation-domain
Packit Service fb6fa5
Read / Write
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Types and Values

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
struct
Packit Service fb6fa5
GtkBuilder
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
enum
Packit Service fb6fa5
GtkBuilderError
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
#define
Packit Service fb6fa5
GTK_BUILDER_ERROR
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Object Hierarchy

Packit Service fb6fa5
    GObject
Packit Service fb6fa5
    ╰── GtkBuilder
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Includes

Packit Service fb6fa5
#include <gtk/gtk.h>
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Description

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Functions

Packit Service fb6fa5
Packit Service fb6fa5

GtkBuilderConnectFunc ()

Packit Service fb6fa5
void
Packit Service fb6fa5
(*GtkBuilderConnectFunc) (GtkBuilder *builder,
Packit Service fb6fa5
                          GObject *object,
Packit Service fb6fa5
                          const gchar *signal_name,
Packit Service fb6fa5
                          const gchar *handler_name,
Packit Service fb6fa5
                          GObject *connect_object,
Packit Service fb6fa5
                          GConnectFlags flags,
Packit Service fb6fa5
                          gpointer user_data);
Packit Service fb6fa5

This is the signature of a function used to connect signals. It is used

Packit Service fb6fa5
by the gtk_builder_connect_signals() and gtk_builder_connect_signals_full()
Packit Service fb6fa5
methods.  It is mainly intended for interpreted language bindings, but
Packit Service fb6fa5
could be useful where the programmer wants more control over the signal
Packit Service fb6fa5
connection process.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

object

Packit Service fb6fa5

object to connect a signal to

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

signal_name

Packit Service fb6fa5

name of the signal

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

handler_name

Packit Service fb6fa5

name of the handler

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

connect_object

Packit Service fb6fa5

a GObject, if non-NULL, use g_signal_connect_object()

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

flags

Packit Service fb6fa5

GConnectFlags to use

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

user_data

Packit Service fb6fa5

user data

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_new ()

Packit Service fb6fa5
GtkBuilder *
Packit Service fb6fa5
gtk_builder_new (void);
Packit Service fb6fa5

Creates a new builder object.

Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

a new GtkBuilder object

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_add_from_file ()

Packit Service fb6fa5
guint
Packit Service fb6fa5
gtk_builder_add_from_file (GtkBuilder *builder,
Packit Service fb6fa5
                           const gchar *filename,
Packit Service fb6fa5
                           GError **error);
Packit Service fb6fa5

Parses a file containing a <GTKDOCLINK HREF="BUILDER-UI">GtkBuilder

Packit Service fb6fa5
UI definition</GTKDOCLINK> and merges it with the current contents of builder
Packit Service fb6fa5
. 

Packit Service fb6fa5

Upon errors 0 will be returned and error

Packit Service fb6fa5
 will be assigned a
Packit Service fb6fa5
GError from the GTK_BUILDER_ERROR, G_MARKUP_ERROR or G_FILE_ERROR 
Packit Service fb6fa5
domain.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

filename

Packit Service fb6fa5

the name of the file to parse

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

error

Packit Service fb6fa5

return location for an error, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

A positive value on success, 0 if an error occurred

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_add_from_string ()

Packit Service fb6fa5
guint
Packit Service fb6fa5
gtk_builder_add_from_string (GtkBuilder *builder,
Packit Service fb6fa5
                             const gchar *buffer,
Packit Service fb6fa5
                             gsize length,
Packit Service fb6fa5
                             GError **error);
Packit Service fb6fa5

Parses a string containing a <GTKDOCLINK HREF="BUILDER-UI">GtkBuilder

Packit Service fb6fa5
UI definition</GTKDOCLINK> and merges it with the current contents of builder
Packit Service fb6fa5
. 

Packit Service fb6fa5

Upon errors 0 will be returned and error

Packit Service fb6fa5
 will be assigned a
Packit Service fb6fa5
GError from the GTK_BUILDER_ERROR or G_MARKUP_ERROR domain.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

buffer

Packit Service fb6fa5

the string to parse

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

length

Packit Service fb6fa5

the length of buffer

Packit Service fb6fa5
(may be -1 if buffer
Packit Service fb6fa5
is nul-terminated)

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

error

Packit Service fb6fa5

return location for an error, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

A positive value on success, 0 if an error occurred

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_add_objects_from_file ()

Packit Service fb6fa5
guint
Packit Service fb6fa5
gtk_builder_add_objects_from_file (GtkBuilder *builder,
Packit Service fb6fa5
                                   const gchar *filename,
Packit Service fb6fa5
                                   gchar **object_ids,
Packit Service fb6fa5
                                   GError **error);
Packit Service fb6fa5

Parses a file containing a <GTKDOCLINK HREF="BUILDER-UI">GtkBuilder

Packit Service fb6fa5
UI definition</GTKDOCLINK> building only the requested objects and merges
Packit Service fb6fa5
them with the current contents of builder
Packit Service fb6fa5
. 

Packit Service fb6fa5

Upon errors 0 will be returned and error

Packit Service fb6fa5
 will be assigned a
Packit Service fb6fa5
GError from the GTK_BUILDER_ERROR, G_MARKUP_ERROR or G_FILE_ERROR 
Packit Service fb6fa5
domain.

Packit Service fb6fa5

Packit Service fb6fa5
If you are adding an object that depends on an object that is not 
Packit Service fb6fa5
its child (for instance a GtkTreeView that depends on its
Packit Service fb6fa5
GtkTreeModel), you have to explicitely list all of them in object_ids. 
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

filename

Packit Service fb6fa5

the name of the file to parse

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

object_ids

Packit Service fb6fa5

nul-terminated array of objects to build

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

error

Packit Service fb6fa5

return location for an error, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

A positive value on success, 0 if an error occurred

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.14

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_add_objects_from_string ()

Packit Service fb6fa5
guint
Packit Service fb6fa5
gtk_builder_add_objects_from_string (GtkBuilder *builder,
Packit Service fb6fa5
                                     const gchar *buffer,
Packit Service fb6fa5
                                     gsize length,
Packit Service fb6fa5
                                     gchar **object_ids,
Packit Service fb6fa5
                                     GError **error);
Packit Service fb6fa5

Parses a string containing a <GTKDOCLINK HREF="BUILDER-UI">GtkBuilder

Packit Service fb6fa5
UI definition</GTKDOCLINK> building only the requested objects and merges
Packit Service fb6fa5
them with the current contents of builder
Packit Service fb6fa5
. 

Packit Service fb6fa5

Upon errors 0 will be returned and error

Packit Service fb6fa5
 will be assigned a
Packit Service fb6fa5
GError from the GTK_BUILDER_ERROR or G_MARKUP_ERROR domain.

Packit Service fb6fa5

Packit Service fb6fa5
If you are adding an object that depends on an object that is not 
Packit Service fb6fa5
its child (for instance a GtkTreeView that depends on its
Packit Service fb6fa5
GtkTreeModel), you have to explicitely list all of them in object_ids. 
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

buffer

Packit Service fb6fa5

the string to parse

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

length

Packit Service fb6fa5

the length of buffer

Packit Service fb6fa5
(may be -1 if buffer
Packit Service fb6fa5
is nul-terminated)

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

object_ids

Packit Service fb6fa5

nul-terminated array of objects to build

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

error

Packit Service fb6fa5

return location for an error, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

A positive value on success, 0 if an error occurred

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.14

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_get_object ()

Packit Service fb6fa5
GObject *
Packit Service fb6fa5
gtk_builder_get_object (GtkBuilder *builder,
Packit Service fb6fa5
                        const gchar *name);
Packit Service fb6fa5

Gets the object named name

Packit Service fb6fa5
. Note that this function does not
Packit Service fb6fa5
increment the reference count of the returned object.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

name

Packit Service fb6fa5

name of object to get

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

the object named name

Packit Service fb6fa5
or NULL if
Packit Service fb6fa5
it could not be found in the object tree. 

Packit Service fb6fa5

[transfer none]

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_get_objects ()

Packit Service fb6fa5
GSList *
Packit Service fb6fa5
gtk_builder_get_objects (GtkBuilder *builder);
Packit Service fb6fa5

Gets all objects that have been constructed by builder

Packit Service fb6fa5
. Note that 
Packit Service fb6fa5
this function does not increment the reference counts of the returned
Packit Service fb6fa5
objects.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

a newly-allocated GSList containing all the objects

Packit Service fb6fa5
constructed by the GtkBuilder instance. It should be freed by
Packit Service fb6fa5
g_slist_free(). 

Packit Service fb6fa5

[element-type GObject][transfer container]

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_connect_signals ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_builder_connect_signals (GtkBuilder *builder,
Packit Service fb6fa5
                             gpointer user_data);
Packit Service fb6fa5

This method is a simpler variation of gtk_builder_connect_signals_full().

Packit Service fb6fa5
It uses GModule's introspective features (by opening the module NULL) 
Packit Service fb6fa5
to look at the application's symbol table. From here it tries to match
Packit Service fb6fa5
the signal handler names given in the interface description with
Packit Service fb6fa5
symbols in the application and connects the signals.

Packit Service fb6fa5

Note that this function will not work correctly if GModule is not

Packit Service fb6fa5
supported on the platform.

Packit Service fb6fa5

When compiling applications for Windows, you must declare signal callbacks

Packit Service fb6fa5
with G_MODULE_EXPORT, or they will not be put in the symbol table.
Packit Service fb6fa5
On Linux and Unices, this is not necessary; applications should instead
Packit Service fb6fa5
be compiled with the -Wl,--export-dynamic CFLAGS, and linked against
Packit Service fb6fa5
gmodule-export-2.0.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

user_data

Packit Service fb6fa5

a pointer to a structure sent in as user data to all signals

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_connect_signals_full ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_builder_connect_signals_full (GtkBuilder *builder,
Packit Service fb6fa5
                                  GtkBuilderConnectFunc func,
Packit Service fb6fa5
                                  gpointer user_data);
Packit Service fb6fa5

This function can be thought of the interpreted language binding

Packit Service fb6fa5
version of gtk_builder_connect_signals(), except that it does not
Packit Service fb6fa5
require GModule to function correctly.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

func

Packit Service fb6fa5

the function used to connect the signals.

Packit Service fb6fa5
[scope call]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

user_data

Packit Service fb6fa5

arbitrary data that will be passed to the connection function

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_set_translation_domain ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_builder_set_translation_domain (GtkBuilder *builder,
Packit Service fb6fa5
                                    const gchar *domain);
Packit Service fb6fa5

Sets the translation domain of builder

Packit Service fb6fa5
. 
Packit Service fb6fa5
See “translation-domain”.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

domain

Packit Service fb6fa5

the translation domain or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_get_translation_domain ()

Packit Service fb6fa5
const gchar *
Packit Service fb6fa5
gtk_builder_get_translation_domain (GtkBuilder *builder);
Packit Service fb6fa5

Gets the translation domain of builder

Packit Service fb6fa5
.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

the translation domain. This string is owned

Packit Service fb6fa5
by the builder object and must not be modified or freed.

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_get_type_from_name ()

Packit Service fb6fa5
GType
Packit Service fb6fa5
gtk_builder_get_type_from_name (GtkBuilder *builder,
Packit Service fb6fa5
                                const char *type_name);
Packit Service fb6fa5

Looks up a type by name, using the virtual function that

Packit Service fb6fa5
GtkBuilder has for that purpose. This is mainly used when
Packit Service fb6fa5
implementing the GtkBuildable interface on a type.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

type_name

Packit Service fb6fa5

type name to lookup

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

the GType found for type_name

Packit Service fb6fa5
or G_TYPE_INVALID
Packit Service fb6fa5
if no type was found

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_value_from_string ()

Packit Service fb6fa5
gboolean
Packit Service fb6fa5
gtk_builder_value_from_string (GtkBuilder *builder,
Packit Service fb6fa5
                               GParamSpec *pspec,
Packit Service fb6fa5
                               const gchar *string,
Packit Service fb6fa5
                               GValue *value,
Packit Service fb6fa5
                               GError **error);
Packit Service fb6fa5

This function demarshals a value from a string. This function

Packit Service fb6fa5
calls g_value_init() on the value
Packit Service fb6fa5
 argument, so it need not be
Packit Service fb6fa5
initialised beforehand.

Packit Service fb6fa5

This function can handle char, uchar, boolean, int, uint, long,

Packit Service fb6fa5
ulong, enum, flags, float, double, string, GdkColor and
Packit Service fb6fa5
GtkAdjustment type values. Support for GtkWidget type values is
Packit Service fb6fa5
still to come.

Packit Service fb6fa5

Upon errors FALSE will be returned and error

Packit Service fb6fa5
 will be assigned a
Packit Service fb6fa5
GError from the GTK_BUILDER_ERROR domain.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

pspec

Packit Service fb6fa5

the GParamSpec for the property

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

string

Packit Service fb6fa5

the string representation of the value

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

value

Packit Service fb6fa5

the GValue to store the result in.

Packit Service fb6fa5
[out]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

error

Packit Service fb6fa5

return location for an error, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

TRUE on success

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_builder_value_from_string_type ()

Packit Service fb6fa5
gboolean
Packit Service fb6fa5
gtk_builder_value_from_string_type (GtkBuilder *builder,
Packit Service fb6fa5
                                    GType type,
Packit Service fb6fa5
                                    const gchar *string,
Packit Service fb6fa5
                                    GValue *value,
Packit Service fb6fa5
                                    GError **error);
Packit Service fb6fa5

Like gtk_builder_value_from_string(), this function demarshals

Packit Service fb6fa5
a value from a string, but takes a GType instead of GParamSpec.
Packit Service fb6fa5
This function calls g_value_init() on the value
Packit Service fb6fa5
 argument, so it 
Packit Service fb6fa5
need not be initialised beforehand.

Packit Service fb6fa5

Upon errors FALSE will be returned and error

Packit Service fb6fa5
 will be assigned a
Packit Service fb6fa5
GError from the GTK_BUILDER_ERROR domain.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

builder

Packit Service fb6fa5

a GtkBuilder

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

type

Packit Service fb6fa5

the GType of the value

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

string

Packit Service fb6fa5

the string representation of the value

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

value

Packit Service fb6fa5

the GValue to store the result in.

Packit Service fb6fa5
[out]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

error

Packit Service fb6fa5

return location for an error, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

TRUE on success

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_WARN_INVALID_CHILD_TYPE()

Packit Service fb6fa5
#define             GTK_BUILDER_WARN_INVALID_CHILD_TYPE(object, type)
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Types and Values

Packit Service fb6fa5
Packit Service fb6fa5

struct GtkBuilder

Packit Service fb6fa5
struct GtkBuilder;
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

enum GtkBuilderError

Packit Service fb6fa5
Packit Service fb6fa5

Members

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR_INVALID_TYPE_FUNCTION

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR_UNHANDLED_TAG

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR_MISSING_ATTRIBUTE

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR_INVALID_ATTRIBUTE

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR_INVALID_TAG

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR_MISSING_PROPERTY_VALUE

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR_INVALID_VALUE

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR_VERSION_MISMATCH

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR_DUPLICATE_ID

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

GTK_BUILDER_ERROR

Packit Service fb6fa5
#define GTK_BUILDER_ERROR                (gtk_builder_error_quark ())
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Property Details

Packit Service fb6fa5
Packit Service fb6fa5

The “translation-domain” property

Packit Service fb6fa5
  “translation-domain”       gchar *
Packit Service fb6fa5

The translation domain used when translating property values that

Packit Service fb6fa5
have been marked as translatable in interface descriptions.
Packit Service fb6fa5
If the translation domain is NULL, GtkBuilder uses gettext(),
Packit Service fb6fa5
otherwise g_dgettext().

Packit Service fb6fa5

Flags: Read / Write

Packit Service fb6fa5

Default value: NULL

Packit Service fb6fa5

Since: 2.12

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Generated by GTK-Doc V1.26.1
Packit Service fb6fa5
</body>
Packit Service fb6fa5
</html>