gtkmm: Gtk::BoxLayout Class Reference
Layout manager for placing all children in a single row or column. More...
#include <gtkmm/boxlayout.h>
Public Member Functions | |
BoxLayout (BoxLayout&& src) noexcept | |
BoxLayout& | operator= (BoxLayout&& src) noexcept |
~BoxLayout () noexcept override | |
GtkBoxLayout* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkBoxLayout* | gobj () const |
Provides access to the underlying C GObject. More... | |
GtkBoxLayout* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More... | |
void | set_homogeneous (bool homogeneous=true) |
Sets whether the box layout will allocate the same size to all children. More... | |
bool | get_homogeneous () const |
Returns whether the layout is set to be homogeneous. More... | |
void | set_spacing (guint spacing) |
Sets how much spacing to put between children. More... | |
guint | get_spacing () const |
Returns the space that box_layout puts between children. More... | |
void | set_baseline_position (BaselinePosition position) |
Sets the baseline position of a box layout. More... | |
BaselinePosition | get_baseline_position () const |
Gets the value set by set_baseline_position(). More... | |
Glib::PropertyProxy< bool > | property_homogeneous () |
Whether the box layout should distribute the available space homogeneously among the children of the widget using it as a layout manager. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_homogeneous () const |
Whether the box layout should distribute the available space homogeneously among the children of the widget using it as a layout manager. More... | |
Glib::PropertyProxy< int > | property_spacing () |
The space between each child of the widget using the box layout as its layout manager. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_spacing () const |
The space between each child of the widget using the box layout as its layout manager. More... | |
Glib::PropertyProxy< BaselinePosition > | property_baseline_position () |
The position of the allocated baseline within the extra space allocated to each child of the widget using a box layout manager. More... | |
Glib::PropertyProxy_ReadOnly< BaselinePosition > | property_baseline_position () const |
The position of the allocated baseline within the extra space allocated to each child of the widget using a box layout manager. More... | |
Public Member Functions inherited from Gtk::LayoutManager | |
LayoutManager (LayoutManager&& src) noexcept | |
LayoutManager& | operator= (LayoutManager&& src) noexcept |
~LayoutManager () noexcept override | |
GtkLayoutManager* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkLayoutManager* | gobj () const |
Provides access to the underlying C GObject. More... | |
GtkLayoutManager* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More... | |
void | measure (Widget& widget, Orientation orientation, int for_size, int& minimum, int& natural, int& minimum_baseline, int& natural_baseline) const |
Measures the size of the widget using manager, for the given orientation and size. More... | |
void | allocate (Widget& widget, int width, int height, int baseline) |
This function assigns the given width, height, and baseline to a widget, and computes the position and sizes of the children of the widget using the layout management policy of manager. More... | |
SizeRequestMode | get_request_mode () const |
Retrieves the request mode of manager. More... | |
Widget* | get_widget () |
Retrieves the Gtk::Widget using the given Gtk::LayoutManager. More... | |
const Widget* | get_widget () const |
Retrieves the Gtk::Widget using the given Gtk::LayoutManager. More... | |
void | layout_changed () |
Queues a resize on the Gtk::Widget using manager, if any. More... | |
Glib::RefPtr< LayoutChild > | get_layout_child (Widget& child) |
Retrieves a Gtk::LayoutChild instance for the Gtk::LayoutManager, creating one if necessary. More... | |
Glib::RefPtr< const LayoutChild > | get_layout_child (Widget& child) const |
Retrieves a Gtk::LayoutChild instance for the Gtk::LayoutManager, creating one if necessary. More... | |
Public Member Functions inherited from Glib::Object | |
Object (const Object &)=delete | |
Object & | operator= (const Object &)=delete |
Object (Object &&src) noexcept | |
Object & | operator= (Object &&src) noexcept |
void * | get_data (const QueryQuark &key) |
void | set_data (const Quark &key, void *data) |
void | set_data (const Quark &key, void *data, DestroyNotify notify) |
void | remove_data (const QueryQuark &quark) |
void * | steal_data (const QueryQuark &quark) |
Glib::RefPtr< Glib::Object > | wrap (GObject *object, bool take_copy=false) |
Public Member Functions inherited from Glib::ObjectBase | |
ObjectBase (const ObjectBase &)=delete | |
ObjectBase & | operator= (const ObjectBase &)=delete |
void | set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value) |
void | get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const |
void | set_property (const Glib::ustring &property_name, const PropertyType &value) |
void | get_property (const Glib::ustring &property_name, PropertyType &value) const |
PropertyType | get_property (const Glib::ustring &property_name) const |
sigc::connection | connect_property_changed (const Glib::ustring &property_name, const sigc::slot< void()> &slot) |
sigc::connection | connect_property_changed (const Glib::ustring &property_name, sigc::slot< void()> &&slot) |
void | freeze_notify () |
void | thaw_notify () |
virtual void | reference () const |
virtual void | unreference () const |
GObject * | gobj () |
const GObject * | gobj () const |
GObject * | gobj_copy () const |
Public Member Functions inherited from sigc::trackable | |
trackable () noexcept | |
trackable (const trackable &src) noexcept | |
trackable (trackable &&src) noexcept | |
~trackable () | |
void | add_destroy_notify_callback (notifiable *data, func_destroy_notify func) const |
void | notify_callbacks () |
trackable & | operator= (const trackable &src) |
trackable & | operator= (trackable &&src) noexcept |
void | remove_destroy_notify_callback (notifiable *data) const |
Public Member Functions inherited from Gtk::Orientable | |
Orientable (Orientable&& src) noexcept | |
Orientable& | operator= (Orientable&& src) noexcept |
~Orientable () noexcept override | |
GtkOrientable* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkOrientable* | gobj () const |
Provides access to the underlying C GObject. More... | |
void | set_orientation (Orientation orientation) |
Sets the orientation of the orientable. More... | |
Orientation | get_orientation () const |
Retrieves the orientation of the orientable. More... | |
Glib::PropertyProxy< Orientation > | property_orientation () |
The orientation of the orientable. More... | |
Glib::PropertyProxy_ReadOnly< Orientation > | property_orientation () const |
The orientation of the orientable. More... | |
Public Member Functions inherited from Glib::Interface | |
Interface () | |
Interface (Interface &&src) noexcept | |
Interface & | operator= (Interface &&src) noexcept |
Interface (const Glib::Interface_Class &interface_class) | |
Interface (GObject *castitem) | |
~Interface () noexcept override | |
Interface (const Interface &)=delete | |
Interface & | operator= (const Interface &)=delete |
GObject * | gobj () |
const GObject * | gobj () const |
Static Public Member Functions | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
static Glib::RefPtr< BoxLayout > | create (Orientation orientation=Orientation::HORIZONTAL) |
Static Public Member Functions inherited from Gtk::LayoutManager | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
Static Public Member Functions inherited from Gtk::Orientable | |
static void | add_interface (GType gtype_implementer) |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
Protected Member Functions | |
BoxLayout (Orientation orientation=Orientation::HORIZONTAL) | |
Protected Member Functions inherited from Gtk::LayoutManager | |
LayoutManager () | |
There is no create() method that corresponds to this constructor, because only derived classes shall be created. More... | |
virtual SizeRequestMode | get_request_mode_vfunc (const Widget& widget) const |
virtual void | measure_vfunc (const Widget& widget, Orientation orientation, int for_size, int& minimum, int& natural, int& minimum_baseline, int& natural_baseline) const |
virtual void | allocate_vfunc (const Widget& widget, int width, int height, int baseline) |
virtual Glib::RefPtr< LayoutChild > | create_layout_child_vfunc (const Widget& widget, const Widget& for_child) |
virtual void | root_vfunc () |
virtual void | unroot_vfunc () |
Protected Member Functions inherited from Glib::Object | |
Object () | |
Object (const Glib::ConstructParams &construct_params) | |
Object (GObject *castitem) | |
~Object () noexcept override | |
Protected Member Functions inherited from Glib::ObjectBase | |
ObjectBase () | |
ObjectBase (const char *custom_type_name) | |
ObjectBase (const std::type_info &custom_type_info) | |
ObjectBase (ObjectBase &&src) noexcept | |
ObjectBase & | operator= (ObjectBase &&src) noexcept |
virtual | ~ObjectBase () noexcept=0 |
void | initialize (GObject *castitem) |
void | initialize_move (GObject *castitem, Glib::ObjectBase *previous_wrapper) |
Protected Member Functions inherited from Gtk::Orientable | |
Orientable () | |
You should derive from this class to use it. More... | |
Related Functions | |
(Note that these are not member functions.) | |
Glib::RefPtr< Gtk::BoxLayout > | wrap (GtkBoxLayout* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
Related Functions inherited from Gtk::LayoutManager | |
Glib::RefPtr< Gtk::LayoutManager > | wrap (GtkLayoutManager* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
Related Functions inherited from Gtk::Orientable | |
Glib::RefPtr< Gtk::Orientable > | wrap (GtkOrientable* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
Additional Inherited Members | |
Public Types inherited from Glib::Object | |
typedef void(*)(gpointer data | DestroyNotify) |
Public Types inherited from sigc::trackable | |
typedef internal::func_destroy_notify | func_destroy_notify |
Public Types inherited from sigc::notifiable | |
typedef internal::func_destroy_notify | func_destroy_notify |
Detailed Description
Layout manager for placing all children in a single row or column.
A Gtk::BoxLayout is a layout manager that arranges the children of any widget using it into a single row or column, depending on the value of its Gtk::Orientable::property_orientation(). Within the other dimension all children all allocated the same size. The Gtk::BoxLayout will respect Gtk::Widget::property_halign() and Gtk::Widget::property_valign() of each child widget.
If you want all children to be assigned the same size, you can use property_homogeneous().
If you want to specify the amount of space placed between each child, you can use the property_spacing().
Constructor & Destructor Documentation
|
noexcept |
|
overridenoexcept |
|
explicitprotected |
Member Function Documentation
|
static |
BaselinePosition Gtk::BoxLayout::get_baseline_position | ( | ) | const |
Gets the value set by set_baseline_position().
- Returns
- The baseline position.
bool Gtk::BoxLayout::get_homogeneous | ( | ) | const |
Returns whether the layout is set to be homogeneous.
Return: true
if the layout is homogeneous
guint Gtk::BoxLayout::get_spacing | ( | ) | const |
Returns the space that box_layout puts between children.
- Returns
- The spacing of the layout.
|
static |
Get the GType for this class, for use with the underlying GObject type system.
|
inline |
Provides access to the underlying C GObject.
|
inline |
Provides access to the underlying C GObject.
GtkBoxLayout* Gtk::BoxLayout::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
Glib::PropertyProxy< BaselinePosition > Gtk::BoxLayout::property_baseline_position | ( | ) |
The position of the allocated baseline within the extra space allocated to each child of the widget using a box layout manager.
This property is only relevant for horizontal layouts containing at least one child with a baseline alignment.
Default value: Gtk::BaselinePosition::CENTER
- Returns
- A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< BaselinePosition > Gtk::BoxLayout::property_baseline_position | ( | ) | const |
The position of the allocated baseline within the extra space allocated to each child of the widget using a box layout manager.
This property is only relevant for horizontal layouts containing at least one child with a baseline alignment.
Default value: Gtk::BaselinePosition::CENTER
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< bool > Gtk::BoxLayout::property_homogeneous | ( | ) |
Whether the box layout should distribute the available space homogeneously among the children of the widget using it as a layout manager.
Default value: false
- Returns
- A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< bool > Gtk::BoxLayout::property_homogeneous | ( | ) | const |
Whether the box layout should distribute the available space homogeneously among the children of the widget using it as a layout manager.
Default value: false
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy< int > Gtk::BoxLayout::property_spacing | ( | ) |
The space between each child of the widget using the box layout as its layout manager.
Default value: 0
- Returns
- A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< int > Gtk::BoxLayout::property_spacing | ( | ) | const |
The space between each child of the widget using the box layout as its layout manager.
Default value: 0
- Returns
- A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
void Gtk::BoxLayout::set_baseline_position | ( | BaselinePosition | position | ) |
Sets the baseline position of a box layout.
The baseline position affects only horizontal boxes with at least one baseline aligned child. If there is more vertical space available than requested, and the baseline is not allocated by the parent then the given position is used to allocate the baseline within the extra space available.
- Parameters
-
position A Gtk::BaselinePosition.
void Gtk::BoxLayout::set_homogeneous | ( | bool | homogeneous = true | ) |
Sets whether the box layout will allocate the same size to all children.
- Parameters
-
homogeneous true
to set the box layout as homogeneous.
void Gtk::BoxLayout::set_spacing | ( | guint | spacing | ) |
Sets how much spacing to put between children.
- Parameters
-
spacing The spacing to apply between children.
Friends And Related Function Documentation
|
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.