gtkmm 2.24.2
Public Member Functions | Related Functions

Gtk::ButtonBox Class Reference

Base class for Gtk::HButtonBox and Gtk::VButtonBox. More...

Inheritance diagram for Gtk::ButtonBox:
Inheritance graph
[legend]
Collaboration diagram for Gtk::ButtonBox:
Collaboration graph
[legend]

List of all members.

Public Member Functions

virtual ~ButtonBox ()
GtkButtonBox* gobj ()
 Provides access to the underlying C GtkObject.
const GtkButtonBox* gobj () const
 Provides access to the underlying C GtkObject.
ButtonBoxStyle get_layout () const
void set_layout (ButtonBoxStyle layout_style)
void set_child_secondary (Widget& child, bool is_secondary=true)
 Sets whether child should appear in a secondary group of children.
bool get_child_secondary (const Gtk::Widget& child) const
 Returns whether child should appear in a secondary group of children.
int get_child_min_width () const
void set_child_min_width (const int&value)
int get_child_min_height () const
void set_child_min_height (const int&value)
int get_child_ipadding_x () const
void set_child_ipadding_x (const int&value)
int get_child_ipadding_y () const
void set_child_ipadding_y (const int&value)
Glib::PropertyProxy
< ButtonBoxStyle
property_layout_style ()
 How to lay out the buttons in the box.
Glib::PropertyProxy_ReadOnly
< ButtonBoxStyle
property_layout_style () const
 How to lay out the buttons in the box.

Related Functions

(Note that these are not member functions.)
Gtk::ButtonBoxwrap (GtkButtonBox* object, bool take_copy=false)
 A Glib::wrap() method for this object.

Detailed Description

Base class for Gtk::HButtonBox and Gtk::VButtonBox.

A button box should be used to provide a consistent layout of buttons throughout your application. There is one default layout and a default spacing value that are persistant across all ButtonBox widgets.


Constructor & Destructor Documentation

virtual Gtk::ButtonBox::~ButtonBox ( ) [virtual]

Member Function Documentation

int Gtk::ButtonBox::get_child_ipadding_x ( ) const
int Gtk::ButtonBox::get_child_ipadding_y ( ) const
int Gtk::ButtonBox::get_child_min_height ( ) const
int Gtk::ButtonBox::get_child_min_width ( ) const
bool Gtk::ButtonBox::get_child_secondary ( const Gtk::Widget child) const

Returns whether child should appear in a secondary group of children.

Since gtkmm 2.4:
Parameters:
childA child of widget.
Returns:
Whether child should appear in a secondary group of children.
ButtonBoxStyle Gtk::ButtonBox::get_layout ( ) const
const GtkButtonBox* Gtk::ButtonBox::gobj ( ) const [inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::Box.

Reimplemented in Gtk::VButtonBox, and Gtk::HButtonBox.

GtkButtonBox* Gtk::ButtonBox::gobj ( ) [inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::Box.

Reimplemented in Gtk::VButtonBox, and Gtk::HButtonBox.

Glib::PropertyProxy_ReadOnly<ButtonBoxStyle> Gtk::ButtonBox::property_layout_style ( ) const

How to lay out the buttons in the box.

Possible values are: default, spread, edge, start and end.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy<ButtonBoxStyle> Gtk::ButtonBox::property_layout_style ( )

How to lay out the buttons in the box.

Possible values are: default, spread, edge, start and end.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
void Gtk::ButtonBox::set_child_ipadding_x ( const int &  value)
void Gtk::ButtonBox::set_child_ipadding_y ( const int &  value)
void Gtk::ButtonBox::set_child_min_height ( const int &  value)
void Gtk::ButtonBox::set_child_min_width ( const int &  value)
void Gtk::ButtonBox::set_child_secondary ( Widget child,
bool  is_secondary = true 
)

Sets whether child should appear in a secondary group of children.

A typical use of a secondary child is the help button in a dialog.

This group appears after the other children if the style is Gtk::BUTTONBOX_START, Gtk::BUTTONBOX_SPREAD or Gtk::BUTTONBOX_EDGE, and before the other children if the style is Gtk::BUTTONBOX_END. For horizontal button boxes, the definition of before/after depends on direction of the widget (see Gtk::Widget::set_direction()). If the style is Gtk::BUTTONBOX_START or Gtk::BUTTONBOX_END, then the secondary children are aligned at the other end of the button box from the main children. For the other styles, they appear immediately next to the main children.

Parameters:
childA child of widget.
is_secondaryIf true, the child appears in a secondary group of the button box.
void Gtk::ButtonBox::set_layout ( ButtonBoxStyle  layout_style)

Friends And Related Function Documentation

Gtk::ButtonBox* wrap ( GtkButtonBox *  object,
bool  take_copy = false 
) [related]

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

Parameters:
objectThe C instance.
take_copyFalse 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: