# Gtk::Buildable Class Reference

A base class for objects that can be built by Gtk::Builder. More...

Inheritance diagram for Gtk::Buildable:
[legend]

List of all members.

## Public Member Functions

virtual | ~Buildable ()
GtkBuildable* | gobj ()
| Provides access to the underlying C GObject.
const GtkBuildable* | gobj () const
| Provides access to the underlying C GObject.
void | set_name (const Glib::ustring& name)
| Sets the name of the buildable object.
Glib::ustring | get_name () const
| Gets the name of the buildable object.

## Static Public Member Functions

static void | add_interface (GType gtype_implementer)

## Related Functions

(Note that these are not member functions.)
Glib::RefPtr< Gtk::Buildable > | wrap (GtkBuildable* object, bool take_copy=false)
| A Glib::wrap() method for this object.

## Detailed Description

A base class for objects that can be built by Gtk::Builder.

Buildable allows objects to extend and customize thier deserialization from Gtk::Builder UI descriptions. The interface includes methods for setting names and properties of objects, parsing custom tags and constructing child objects.

All gtkmm widgets, and many non-widget objects, derive from this base class. The main user of this interface is Gtk::Builder. There should be very little need for applications to call any of Buildable's methods.

Since gtkmm 3.0:

## Constructor & Destructor Documentation

virtual Gtk::Buildable::~Buildable | ( |  | ) | `[virtual]`

## Member Function Documentation

static void Gtk::Buildable::add_interface | ( | GType | gtype_implementer | ) | `[static]`

Glib::ustring Gtk::Buildable::get_name | ( |  | ) | const

Gets the name of the buildable object.

Gtk::Builder sets the name based on the the GtkBuilder UI definition used to construct the buildable.

Since gtkmm 2.12:

Returns:
  The name set with set_name().

Reimplemented in Gtk::Action, Gtk::ActionGroup, and Gtk::Widget.

GtkBuildable* Gtk::Buildable::gobj | ( |  | ) | `[inline]`

Provides access to the underlying C GObject.

Reimplemented from Glib::Interface.

Reimplemented in Gtk::AboutDialog, Gtk::AccelLabel, Gtk::Action, Gtk::ActionGroup, Gtk::Alignment, Gtk::AppChooserButton, Gtk::AppChooserDialog, Gtk::AppChooserWidget, Gtk::Arrow, Gtk::AspectFrame, Gtk::Assistant, Gtk::Bin, Gtk::Box, Gtk::Button, Gtk::ButtonBox, Gtk::Calendar, Gtk::CellArea, Gtk::CellAreaBox, Gtk::CellView, Gtk::CheckButton, Gtk::CheckMenuItem, Gtk::ColorButton, Gtk::ColorSelection, Gtk::ColorSelectionDialog, Gtk::ComboBox, Gtk::ComboBoxText, Gtk::Container, Gtk::Dialog, Gtk::DrawingArea, Gtk::Entry, Gtk::EntryCompletion, Gtk::EventBox, Gtk::Expander, Gtk::FileChooserButton, Gtk::FileChooserDialog, Gtk::FileChooserWidget, Gtk::Fixed, Gtk::FontButton, Gtk::FontChooserDialog, Gtk::FontChooserWidget, Gtk::Frame, Gtk::Grid, Gtk::HandleBox, Gtk::IconView, Gtk::Image, Gtk::ImageMenuItem, Gtk::InfoBar, Gtk::Invisible, Gtk::Label, Gtk::Layout, Gtk::LinkButton, Gtk::ListStore, Gtk::Menu, Gtk::MenuBar, Gtk::MenuItem, Gtk::MenuShell, Gtk::MenuToolButton, Gtk::MessageDialog, Gtk::Misc, Gtk::Notebook, Gtk::OffscreenWindow, Gtk::Paned, Gtk::ProgressBar, Gtk::RadioAction, Gtk::RadioButton, Gtk::RadioMenuItem, Gtk::RadioToolButton, Gtk::Range, Gtk::RecentAction, Gtk::RecentChooserDialog, Gtk::RecentChooserMenu, Gtk::RecentChooserWidget, Gtk::Scale, Gtk::ScaleButton, Gtk::Scrollbar, Gtk::ScrolledWindow, Gtk::Separator, Gtk::SeparatorMenuItem, Gtk::SeparatorToolItem, Gtk::SizeGroup, Gtk::SpinButton, Gtk::Spinner, Gtk::Statusbar, Gtk::Switch, Gtk::Table, Gtk::TearoffMenuItem, Gtk::TextView, Gtk::ToggleAction, Gtk::ToggleButton, Gtk::ToggleToolButton, Gtk::Toolbar, Gtk::ToolButton, Gtk::ToolItem, Gtk::ToolItemGroup, Gtk::ToolPalette, Gtk::TreeStore, Gtk::TreeView, Gtk::Viewport, Gtk::VolumeButton, Gtk::Widget, Gtk::Window, Gtk::PageSetupUnixDialog, Gtk::Plug, Gtk::PrintUnixDialog, Gtk::Socket, Gtk::FontSelection, Gtk::FontSelectionDialog, Gtk::VBox, Gtk::HBox, Gtk::VButtonBox, Gtk::HButtonBox, Gtk::HPaned, Gtk::VPaned, Gtk::VScale, Gtk::HScale, Gtk::VScrollbar, Gtk::HScrollbar, Gtk::VSeparator, and Gtk::HSeparator.

const GtkBuildable* Gtk::Buildable::gobj | ( |  | ) | const`[inline]`

Provides access to the underlying C GObject.

Reimplemented from Glib::Interface.

Reimplemented in Gtk::AboutDialog, Gtk::AccelLabel, Gtk::Action, Gtk::ActionGroup, Gtk::Alignment, Gtk::AppChooserButton, Gtk::AppChooserDialog, Gtk::AppChooserWidget, Gtk::Arrow, Gtk::AspectFrame, Gtk::Assistant, Gtk::Bin, Gtk::Box, Gtk::Button, Gtk::ButtonBox, Gtk::Calendar, Gtk::CellArea, Gtk::CellAreaBox, Gtk::CellView, Gtk::CheckButton, Gtk::CheckMenuItem, Gtk::ColorButton, Gtk::ColorSelection, Gtk::ColorSelectionDialog, Gtk::ComboBox, Gtk::ComboBoxText, Gtk::Container, Gtk::Dialog, Gtk::DrawingArea, Gtk::Entry, Gtk::EntryCompletion, Gtk::EventBox, Gtk::Expander, Gtk::FileChooserButton, Gtk::FileChooserDialog, Gtk::FileChooserWidget, Gtk::Fixed, Gtk::FontButton, Gtk::FontChooserDialog, Gtk::FontChooserWidget, Gtk::Frame, Gtk::Grid, Gtk::HandleBox, Gtk::IconView, Gtk::Image, Gtk::ImageMenuItem, Gtk::InfoBar, Gtk::Invisible, Gtk::Label, Gtk::Layout, Gtk::LinkButton, Gtk::ListStore, Gtk::Menu, Gtk::MenuBar, Gtk::MenuItem, Gtk::MenuShell, Gtk::MenuToolButton, Gtk::MessageDialog, Gtk::Misc, Gtk::Notebook, Gtk::OffscreenWindow, Gtk::Paned, Gtk::ProgressBar, Gtk::RadioAction, Gtk::RadioButton, Gtk::RadioMenuItem, Gtk::RadioToolButton, Gtk::Range, Gtk::RecentAction, Gtk::RecentChooserDialog, Gtk::RecentChooserMenu, Gtk::RecentChooserWidget, Gtk::Scale, Gtk::ScaleButton, Gtk::Scrollbar, Gtk::ScrolledWindow, Gtk::Separator, Gtk::SeparatorMenuItem, Gtk::SeparatorToolItem, Gtk::SizeGroup, Gtk::SpinButton, Gtk::Spinner, Gtk::Statusbar, Gtk::Switch, Gtk::Table, Gtk::TearoffMenuItem, Gtk::TextView, Gtk::ToggleAction, Gtk::ToggleButton, Gtk::ToggleToolButton, Gtk::Toolbar, Gtk::ToolButton, Gtk::ToolItem, Gtk::ToolItemGroup, Gtk::ToolPalette, Gtk::TreeStore, Gtk::TreeView, Gtk::Viewport, Gtk::VolumeButton, Gtk::Widget, Gtk::Window, Gtk::PageSetupUnixDialog, Gtk::Plug, Gtk::PrintUnixDialog, Gtk::Socket, Gtk::FontSelection, Gtk::FontSelectionDialog, Gtk::VBox, Gtk::HBox, Gtk::VButtonBox, Gtk::HButtonBox, Gtk::HPaned, Gtk::VPaned, Gtk::VScale, Gtk::HScale, Gtk::VScrollbar, Gtk::HScrollbar, Gtk::VSeparator, and Gtk::HSeparator.

void Gtk::Buildable::set_name | ( | const Glib::ustring & | name | ) |

Sets the name of the buildable object.

Since gtkmm 2.12:

Parameters:

  name | Name to set.

Reimplemented in Gtk::Widget.

## Friends And Related Function Documentation

Glib::RefPtr< Gtk::Buildable > wrap | ( | GtkBuildable * | object,
|  | bool | take_copy = `false`
| ) |  | `[related]`

A Glib::wrap() method for this object.

Parameters:

  object | The C instance.
  take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns:
  A C++ instance that wraps this C instance.

The documentation for this class was generated from the following file:

- gtkmm/buildable.h