Data Structures
struct	constraint_type

Public Types
using	value_type = T

using	alignment_type = std::conditional_t<axis == axis::y, vertical_alignment, horizontal_alignment>

using	cell_type = grid_layout_cell<value_type>

using	cell_vector = std::vector<cell_type>

using	constraint_vector = std::vector<constraint_type>

using	iterator = constraint_vector::iterator

using	const_iterator = constraint_vector::const_iterator

using	reverse_iterator = constraint_vector::reverse_iterator

using	reference = constraint_vector::reference

using	const_reference = constraint_vector::const_reference

Public Member Functions
constexpr	grid_layout_axis_constraints (grid_layout_axis_constraints const &) noexcept=default

constexpr	grid_layout_axis_constraints (grid_layout_axis_constraints &&) noexcept=default

constexpr grid_layout_axis_constraints &	operator= (grid_layout_axis_constraints const &) noexcept=default

constexpr grid_layout_axis_constraints &	operator= (grid_layout_axis_constraints &&) noexcept=default

constexpr	grid_layout_axis_constraints (cell_vector const &cells, size_t num, bool forward) noexcept
	Construct constraints for this axis.

constexpr int	margin_before () const noexcept

constexpr int	margin_after () const noexcept

constexpr int	padding_before () const noexcept

constexpr int	padding_after () const noexcept

constexpr std::tuple< int, int, int >	update_constraints () const noexcept

constexpr std::tuple< int, int, int >	constraints (cell_type const &cell) const noexcept
	Get the minimum, preferred, maximum size of the span.

constexpr int	position (cell_type const &cell) const noexcept

constexpr int	extent (cell_type const &cell) const noexcept

constexpr std::optional< int >	guideline (cell_type const &cell) const noexcept

constexpr void	layout (int new_position, int new_extent, std::optional< int > external_guideline, int guideline_width) noexcept
	Layout each cell along an axis.

constexpr size_t	size () const noexcept
	Number of cell on this axis.

constexpr bool	empty () const noexcept
	Check if this axis is empty.

constexpr iterator	begin () noexcept
	Iterator to the first cell on this axis.

constexpr const_iterator	begin () const noexcept
	Iterator to the first cell on this axis.

constexpr const_iterator	cbegin () const noexcept
	Iterator to the first cell on this axis.

constexpr iterator	end () noexcept
	Iterator to beyond the last cell on this axis.

constexpr const_iterator	end () const noexcept
	Iterator to beyond the last cell on this axis.

constexpr const_iterator	cend () const noexcept
	Iterator to beyond the last cell on this axis.

constexpr reverse_iterator	rbegin () noexcept
	Iterator to the first cell on this axis.

constexpr reverse_iterator	rend () noexcept
	Iterator to the first cell on this axis.

constexpr reference	operator[] (size_t index) noexcept
	Get element.

constexpr const_reference	operator[] (size_t index) const noexcept
	Get element.

constexpr reference	front () noexcept
	Get the first element.

constexpr const_reference	front () const noexcept
	Get the first element.

constexpr reference	back () noexcept
	Get the last element.

constexpr const_reference	back () const noexcept
	Get the last element.

Static Public Attributes
static constexpr hi::axis	axis = Axis

Friends
constexpr friend bool	operator== (grid_layout_axis_constraints const &, grid_layout_axis_constraints const &) noexcept=default

Constructor & Destructor Documentation

◆ grid_layout_axis_constraints()

template<hi::axis Axis, typename T >

constexpr hi::v1::detail::grid_layout_axis_constraints< Axis, T >::grid_layout_axis_constraints	(	cell_vector const &	cells,
		size_t	num,
		bool	forward )

inlineconstexprnoexcept

Construct constraints for this axis.

Parameters

cell	The cells
num	The number of cells in the direction of the current axis
mirrored	true If the axis needs to be mirrored.

Member Function Documentation

◆ back() [1/2]

template<hi::axis Axis, typename T >

constexpr const_reference hi::v1::detail::grid_layout_axis_constraints< Axis, T >::back ( ) const

inlineconstexprnoexcept

Get the last element.

Note: It is undefined behavior to call this function on an empty axis.

Returns: A reference to the last cell.

◆ back() [2/2]

template<hi::axis Axis, typename T >

constexpr reference hi::v1::detail::grid_layout_axis_constraints< Axis, T >::back ( )

inlineconstexprnoexcept

Get the last element.

Note: It is undefined behavior to call this function on an empty axis.

Returns: A reference to the last cell.

◆ begin() [1/2]

template<hi::axis Axis, typename T >

constexpr const_iterator hi::v1::detail::grid_layout_axis_constraints< Axis, T >::begin ( ) const

inlineconstexprnoexcept

Iterator to the first cell on this axis.

◆ begin() [2/2]

template<hi::axis Axis, typename T >

constexpr iterator hi::v1::detail::grid_layout_axis_constraints< Axis, T >::begin ( )

inlineconstexprnoexcept

Iterator to the first cell on this axis.

◆ cbegin()

template<hi::axis Axis, typename T >

constexpr const_iterator hi::v1::detail::grid_layout_axis_constraints< Axis, T >::cbegin ( ) const

inlineconstexprnoexcept

Iterator to the first cell on this axis.

◆ cend()

template<hi::axis Axis, typename T >

constexpr const_iterator hi::v1::detail::grid_layout_axis_constraints< Axis, T >::cend ( ) const

inlineconstexprnoexcept

Iterator to beyond the last cell on this axis.

◆ constraints()

template<hi::axis Axis, typename T >

constexpr std::tuple< int, int, int > hi::v1::detail::grid_layout_axis_constraints< Axis, T >::constraints ( cell_type const & cell ) const

inlineconstexprnoexcept

Get the minimum, preferred, maximum size of the span.

The returned minimum, preferred and maximum include the internal margin within the span.

Parameters

cell	The reference to the cell in the grid.

Returns: The minimum, preferred and maximum size.

◆ empty()

template<hi::axis Axis, typename T >

constexpr bool hi::v1::detail::grid_layout_axis_constraints< Axis, T >::empty ( ) const

inlineconstexprnoexcept

Check if this axis is empty.

◆ end() [1/2]

template<hi::axis Axis, typename T >

constexpr const_iterator hi::v1::detail::grid_layout_axis_constraints< Axis, T >::end ( ) const

inlineconstexprnoexcept

Iterator to beyond the last cell on this axis.

◆ end() [2/2]

template<hi::axis Axis, typename T >

constexpr iterator hi::v1::detail::grid_layout_axis_constraints< Axis, T >::end ( )

inlineconstexprnoexcept

Iterator to beyond the last cell on this axis.

◆ front() [1/2]

template<hi::axis Axis, typename T >

constexpr const_reference hi::v1::detail::grid_layout_axis_constraints< Axis, T >::front ( ) const

inlineconstexprnoexcept

Get the first element.

Note: It is undefined behavior to call this function on an empty axis.

Returns: A reference to the first cell.

◆ front() [2/2]

template<hi::axis Axis, typename T >

constexpr reference hi::v1::detail::grid_layout_axis_constraints< Axis, T >::front ( )

inlineconstexprnoexcept

Get the first element.

Note: It is undefined behavior to call this function on an empty axis.

Returns: A reference to the first cell.

◆ layout()

template<hi::axis Axis, typename T >

constexpr void hi::v1::detail::grid_layout_axis_constraints< Axis, T >::layout	(	int	new_position,
		int	new_extent,
		std::optional< int >	external_guideline,
		int	guideline_width )

inlineconstexprnoexcept

Layout each cell along an axis.

The algorithm works as follows:

Initialize each cell based on its preferred size.
While the grid needs to be shrunk: a. Calculate the amount of cells that are allowed to shrink. b. Apply shrinkage to the cells that are allowed to, up to the minimum. c. If all the cells are maximum shrunk, stop.
While the grid needs to be expanded: a. Calculate the amount of cells that are allowed to expand. b. Apply expansion to the cells that are allowed to, up to the maximum. c. If all the cells are maximum expanded, goto 4.
Expand the largest cell to make it fit.

In an emergency widgets will get a size larger than its maximum. However widgets will never get a smaller size than its minimum.

Parameters

new_position	The start of the grid along its axis.
new_extent	The size of the grid along its axis.
external_guideline	The position of the guideline external from the grid.
guideline_width	The width of the guideline.

◆ operator[]() [1/2]

template<hi::axis Axis, typename T >

constexpr const_reference hi::v1::detail::grid_layout_axis_constraints< Axis, T >::operator[] ( size_t index ) const

inlineconstexprnoexcept

Get element.

Note: It is undefined behavior to index beyond the number of cell on this axis.

Parameters

index The index of the cell.

Returns: A reference to the cell.

◆ operator[]() [2/2]

template<hi::axis Axis, typename T >

constexpr reference hi::v1::detail::grid_layout_axis_constraints< Axis, T >::operator[] ( size_t index )

inlineconstexprnoexcept

Get element.

Note: It is undefined behavior to index beyond the number of cell on this axis.

Parameters

index The index of the cell.

Returns: A reference to the cell.

◆ rbegin()

template<hi::axis Axis, typename T >

constexpr reverse_iterator hi::v1::detail::grid_layout_axis_constraints< Axis, T >::rbegin ( )

inlineconstexprnoexcept

Iterator to the first cell on this axis.

◆ rend()

template<hi::axis Axis, typename T >

constexpr reverse_iterator hi::v1::detail::grid_layout_axis_constraints< Axis, T >::rend ( )

inlineconstexprnoexcept

Iterator to the first cell on this axis.

◆ size()

template<hi::axis Axis, typename T >

constexpr size_t hi::v1::detail::grid_layout_axis_constraints< Axis, T >::size ( ) const

inlineconstexprnoexcept

Number of cell on this axis.

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

hikogui/src/hikogui/layout/grid_layout.hpp

Data Structures

Public Types

Public Member Functions

Static Public Attributes

Friends

Constructor & Destructor Documentation

◆ grid_layout_axis_constraints()

Member Function Documentation

◆ back() [1/2]

◆ back() [2/2]

◆ begin() [1/2]

◆ begin() [2/2]

◆ cbegin()

◆ cend()

◆ constraints()

◆ empty()

◆ end() [1/2]

◆ end() [2/2]

◆ front() [1/2]

◆ front() [2/2]

◆ layout()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ rbegin()

◆ rend()

◆ size()