Xfce Foundation Classes
Main Page  | IndexNamespace List  |  Alphabetical List  |  Class List  |  File List


Xfc::Gtk::ButtonBox Class Reference

A GtkButtonBox C++ wrapper class. More...

#include <xfc/gtk/buttonbox.hh>

Inheritance diagram for Xfc::Gtk::ButtonBox:

Xfc::Gtk::Box Xfc::Gtk::Container Xfc::Gtk::Widget Xfc::Gtk::Object Xfc::Atk::Implementor Xfc::G::Object Xfc::G::TypeInterface Xfc::G::TypeInstance Xfc::G::TypeInstance Xfc::Trackable Xfc::Trackable Xfc::Gtk::HButtonBox Xfc::Gtk::VButtonBox List of all members.

Public Member Functions

Accessors
Methods

Detailed Description

A GtkButtonBox C++ wrapper class.

The primary purpose of ButtonBox is to keep track of the various properties of the HButtonBox and VButtonBox widgets. get_child_size() retrieves the minimum width and height for widgets in a given button box. set_child_size() allows those properties to be changed. The internal padding of buttons can be retrieved and changed per button box using get_child_ipadding() and set_child_ipadding() respectively. get_spacing() and set_spacing() retrieve and change default number of pixels between buttons, respectively. get_layout() and set_layout() retrieve and alter the method used to spread the buttons in a button box across the container, respectively.

See also: the ButtonBox HOWTO and example.


Constructor & Destructor Documentation

Xfc::Gtk::ButtonBox::ButtonBox ( GtkButtonBox *  button_box,
bool  owns_reference = false 
) [explicit, protected]

Construct a new ButtonBox from an existing GtkButtonBox.

Parameters:
button_box A pointer to a GtkButtonBox.
owns_reference Set false if the initial reference count is floating, set true if it's not.
The button_box can be a newly created GtkButtonBox or an existing GtkButtonBox. (see G::Object::Object).

Xfc::Gtk::ButtonBox::ButtonBox ( GtkButtonBox *  button_box,
bool  owns_reference = false 
) [explicit, protected]

Construct a new ButtonBox from an existing GtkButtonBox.

Parameters:
button_box A pointer to a GtkButtonBox.
owns_reference Set false if the initial reference count is floating, set true if it's not.
The button_box can be a newly created GtkButtonBox or an existing GtkButtonBox. (see G::Object::Object).


Member Function Documentation

ButtonBoxStyle Xfc::Gtk::ButtonBox::get_layout (  )  const

Retrieves the method being used to arrange the buttons in a button box.

Returns:
The method used to layout buttons in widget.

bool Xfc::Gtk::ButtonBox::get_child_secondary ( const Widget child  )  const

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

Parameters:
child A child of the button box.
Returns:
Whether child should appear in a secondary group of children.

void Xfc::Gtk::ButtonBox::set_layout ( ButtonBoxStyle  layout_style  ) 

Changes the way buttons are arranged in the button box.

Parameters:
layout_style The new layout style.

void Xfc::Gtk::ButtonBox::set_child_secondary ( Widget child,
bool  is_secondary 
)

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

Parameters:
child A child of widget.
is_secondary If true, the child appears in a secondary group.
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 BUTTONBOX_START, BUTTONBOX_SPREAD or BUTTONBOX_EDGE, and before the other children if the style is 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 BUTTONBOX_START or 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.


The documentation for this class was generated from the following file: Xfce Foundation Classes
Copyright © 2004-2005 The XFC Development Team XFC 4.3