HikoGUI
A low latency retained GUI
Loading...
Searching...
No Matches
Public Types | Public Member Functions | Static Public Attributes
tt::row_column_widget< Axis > Class Template Reference

#include <ttauri/widgets/row_column_widget.hpp>

Inheritance diagram for tt::row_column_widget< Axis >:
tt::widget

Public Types

using super = widget
 
using delegate_type = row_column_delegate<Axis>
 

Public Member Functions

 row_column_widget (gui_window &window, widget *parent, std::weak_ptr< delegate_type > delegate={}) noexcept
 Constructs an empty row/column widget.
 
template<typename Widget , typename... Args>
Widget & make_widget (Args &&...args)
 Add a widget directly to this grid-widget.
 
- Public Member Functions inherited from tt::widget
 widget (gui_window &window, widget *parent) noexcept
 
 widget (const widget &)=delete
 
widgetoperator= (const widget &)=delete
 
 widget (widget &&)=delete
 
widgetoperator= (widget &&)=delete
 
extent2 minimum_size () const noexcept
 Minimum size.
 
extent2 preferred_size () const noexcept
 Preferred size.
 
extent2 maximum_size () const noexcept
 Maximum size.
 
void set_layout_parameters (geo::transformer auto const &local_to_parent, extent2 size, aarectangle const &clipping_rectangle) noexcept
 Set the location and size of the widget inside the window.
 
void set_layout_parameters_from_parent (aarectangle child_rectangle, aarectangle parent_clipping_rectangle, float draw_layer_delta) noexcept
 
void set_layout_parameters_from_parent (aarectangle child_rectangle) noexcept
 
matrix3 parent_to_local () const noexcept
 
matrix3 local_to_parent () const noexcept
 
matrix3 window_to_local () const noexcept
 
matrix3 local_to_window () const noexcept
 
extent2 size () const noexcept
 
float width () const noexcept
 
float height () const noexcept
 
aarectangle rectangle () const noexcept
 Get the rectangle in local coordinates.
 
virtual float base_line () const noexcept
 Return the base-line where the text should be located.
 
aarectangle clipping_rectangle () const noexcept
 
virtual hitbox hitbox_test (point2 position) const noexcept
 Find the widget that is under the mouse cursor.
 
virtual bool accepts_keyboard_focus (keyboard_focus_group group) const noexcept
 Check if the widget will accept keyboard focus.
 
virtual color background_color () const noexcept
 
virtual color foreground_color () const noexcept
 
virtual color focus_color () const noexcept
 
virtual color accent_color () const noexcept
 
virtual color label_color () const noexcept
 
virtual void draw (draw_context context, hires_utc_clock::time_point display_time_point) noexcept
 Draw the widget.
 
virtual void request_redraw () const noexcept
 
virtual bool handle_event (command command) noexcept
 Handle command.
 
virtual bool handle_event (std::vector< command > const &commands) noexcept
 
virtual bool handle_command_recursive (command command, std::vector< widget const * > const &reject_list) noexcept
 Handle command recursive.
 
virtual bool handle_event (mouse_event const &event) noexcept
 
virtual bool handle_event (keyboard_event const &event) noexcept
 Handle keyboard event.
 
virtual widget const * find_next_widget (widget const *current_keyboard_widget, keyboard_focus_group group, keyboard_focus_direction direction) const noexcept
 Find the next widget that handles keyboard focus.
 
widget const * find_first_widget (keyboard_focus_group group) const noexcept
 
widget const * find_last_widget (keyboard_focus_group group) const noexcept
 
bool is_first (keyboard_focus_group group) const noexcept
 Is this widget the first widget in the parent container.
 
bool is_last (keyboard_focus_group group) const noexcept
 Is this widget the last widget in the parent container.
 
virtual void scroll_to_show (tt::rectangle rectangle) noexcept
 Scroll to show the given rectangle on the window.
 
std::vector< widget const * > parent_chain () const noexcept
 Get a list of parents of a given widget.
 
void clear () noexcept
 Remove and deallocate all child widgets.
 
widgetadd_widget (std::unique_ptr< widget > widget) noexcept
 Add a widget directly to this widget.
 

Static Public Attributes

static constexpr tt::axis axis = Axis
 

Additional Inherited Members

- Data Fields inherited from tt::widget
gui_windowwindow
 Convenient reference to the Window.
 
widget *const parent
 Pointer to the parent widget.
 
std::string id
 A name of widget, should be unique between siblings.
 
observable< bool > enabled = true
 The widget is enabled.
 
observable< bool > visible = true
 The widget is visible.
 
float draw_layer
 The draw layer of the widget.
 
int semantic_layer
 The draw layer of the widget.
 
int logical_layer
 The logical layer of the widget.
 

Detailed Description

template<axis Axis>
class tt::row_column_widget< Axis >

A row/column widget lays out child widgets along a row or column.

Columns are laid out from left to right, and rows from top to bottom.

The row/column widget will calculate the size of the row or column based on the minimum, preferred and maximum size of each child widget contained in them. Margins are also taken into account in the spacing between the child-widgets.

When laid out, each child is sized to where it will occupy the full width of a column, or full height of the row; and divide the length of the column or row with the other children.

Template Parameters
Axisthe axis to lay out child widgets. Either axis::horizontal or axis::vertical.

Constructor & Destructor Documentation

◆ row_column_widget()

template<axis Axis>
tt::row_column_widget< Axis >::row_column_widget ( gui_window & window,
widget * parent,
std::weak_ptr< delegate_type > delegate = {} )
inlinenoexcept

Constructs an empty row/column widget.

Parameters
windowThe window.
parentThe parent widget.
delegateAn optional delegate can be used to populate the row/column widget during initialization.

Member Function Documentation

◆ make_widget()

template<axis Axis>
template<typename Widget , typename... Args>
Widget & tt::row_column_widget< Axis >::make_widget ( Args &&... args)
inline

Add a widget directly to this grid-widget.

In a column-widget the newly added widget is added below previously added child-widgets.

In a row-widget the newly added widget is added to the right of previously added child-widgets.

Template Parameters
WidgetThe type of the widget to be constructed.
Parameters
argsThe arguments passed to the constructor of the widget.
Returns
A reference to the widget that was created.

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