---
name: "Gtk2::Builder"
section: "3pm"
platform: "linux"
package: "libgtk2-perl-doc"
version: "2:1.24992-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Gtk2::Builder"
---

# Gtk2::Builder(3pm)

wrapper for GtkBuilder

## NAME

Gtk2::Builder - wrapper for GtkBuilder

## HIERARCHY

```
  Glib::Object
  +----Gtk2::Builder
```

## METHODS

### builder = Gtk2::Builder-\>new

### integer = $builder-\>add\_from\_file ($filename)

- •

  `$filename` (localized file name)

May croak with a Glib::Error in $@ on failure.

### integer = $builder-\>add\_from\_string ($buffer)

- •

  `$buffer` (string)

May croak with a Glib::Error in $@ on failure.

### integer = $builder-\>add\_objects\_from\_string ($buffer, $first\_object\_id, ...)

- •

  `$buffer` (string)

- •

  `$first_object_id` (string)

- •

  ... (list)

Since: gtk+ 2.14

### $builder-\>connect\_signals ($user\_data)

### $builder-\>connect\_signals ($user\_data, $package)

### $builder-\>connect\_signals ($user\_data, %handlers)

There are four ways to let Gtk2::Builder do the signal connecting work for you:

- "$builder-\>connect\_signals ($user\_data)"

  When invoked like this, Gtk2::Builder will connect signals to functions in the calling package.  The callback names are specified in the UI description.

- "$builder-\>connect\_signals ($user\_data, $package)"

  When invoked like this, Gtk2::Builder will connect signals to functions in the package *$package*.

- "$builder-\>connect\_signals ($user\_data, $object)"

  When invoked like this, Gtk2::Builder will connect signals to method calls against the object `$object`.

- "$builder-\>connect\_signals ($user\_data, %handlers)"

  When invoked like this, *%handlers* is used as a mapping from handler names to code references.

### $builder-\>connect\_signals\_full ($func, $user\_data=undef)

- •

  `$func` (scalar)

- •

  `$user_data` (scalar)

### object = $builder-\>get\_object ($name)

- •

  `$name` (string)

### list = $builder-\>get\_objects

### string or undef = $builder-\>get\_translation\_domain

### $builder-\>set\_translation\_domain ($domain)

- •

  `$domain` (string or undef)

## PROPERTIES

- 'translation-domain' (string : default undef : readable / writable / private)

  The translation domain used by gettext

## SEE ALSO

Gtk2, Glib::Object

## COPYRIGHT

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL.  See Gtk2 for a full notice.