scroll_widget.hpp

Go to the documentation of this file.

// Copyright Take Vos 2021-2022.
// Distributed under the Boost Software License, Version 1.0.
// (See accompanying file LICENSE_1_0.txt or copy at https://www.boost.org/LICENSE_1_0.txt)
 
#pragma once
 
#include "../GUI/module.hpp"
#include "scroll_bar_widget.hpp"
#include "scroll_aperture_widget.hpp"
#include "../geometry/module.hpp"
#include "../layout/grid_layout.hpp"
 
namespace hi { inline namespace v1 {
 
template<axis Axis = axis::both, fixed_string Name = "">
class scroll_widget final : public widget {
public:
    using super = widget;
    constexpr static auto prefix = Name / "scroll";
 
    using aperture_type = scroll_aperture_widget<prefix>;
    using horizontal_bar_type = scroll_bar_widget<axis::horizontal, prefix>;
    using vertical_bar_type = scroll_bar_widget<axis::vertical, prefix>;
 
    static constexpr hi::axis axis = Axis;
 
    ~scroll_widget() {}
 
    scroll_widget(widget *parent) noexcept : super(parent)
    {
        hi_axiom(loop::main().on_thread());
        hi_assert_not_null(parent);
 
        // The scroll-widget will not draw itself, only its selected content.
        semantic_layer = parent->semantic_layer;
 
        auto aperture = std::make_unique<aperture_type>(this);
        auto horizontal_bar = std::make_unique<horizontal_bar_type>(
            this, aperture->content_width, aperture->aperture_width, aperture->offset_x);
        auto vertical_bar = std::make_unique<vertical_bar_type>(
            this, aperture->content_height, aperture->aperture_height, aperture->offset_y);
 
        if (to_bool(axis & axis::horizontal)) {
            minimum.copy()->width() = 0;
        } else {
            horizontal_bar->mode = widget_mode::collapse;
        }
 
        if (to_bool(axis & axis::vertical)) {
            minimum.copy()->height() = 0;
        } else {
            vertical_bar->mode = widget_mode::collapse;
        }
 
        _aperture = aperture.get();
        _horizontal_bar = horizontal_bar.get();
        _vertical_bar = vertical_bar.get();
 
        _grid.add_cell(0, 0, std::move(aperture));
        _grid.add_cell(1, 0, std::move(vertical_bar));
        _grid.add_cell(0, 1, std::move(horizontal_bar));
    }
 
    template<typename Widget, typename... Args>
    Widget& make_widget(Args&&...args) noexcept
    {
        return _aperture->make_widget<Widget>(std::forward<Args>(args)...);
    }
 
    [[nodiscard]] generator<widget const&> children(bool include_invisible) const noexcept override
    {
        co_yield *_aperture;
        co_yield *_vertical_bar;
        co_yield *_horizontal_bar;
    }
 
    [[nodiscard]] box_constraints update_constraints() noexcept override
    {
        for (auto& cell : _grid) {
            cell.set_constraints(cell.value->update_constraints());
        }
        auto grid_constraints = _grid.constraints(os_settings::left_to_right());
        return grid_constraints.constrain(*minimum, *maximum);
    }
 
    void set_layout(widget_layout const& context) noexcept override
    {
        if (compare_store(layout, context)) {
            _grid.set_layout(context.shape, theme<prefix>.cap_height(this));
        }
 
        for (hilet& cell : _grid) {
            auto shape = cell.shape;
 
            if (cell.value.get() == _aperture) {
                // This is the content. Move the content slightly when the scroll-bars aren't visible.
                // The grid cells are always ordered in row-major.
                // This the vertical scroll bar is _grid[1] and the horizontal scroll bar is _grid[2].
                if (not _vertical_bar->visible()) {
                    shape.rectangle = aarectanglei{0, shape.y(), layout.width(), shape.height()};
                }
                if (not _horizontal_bar->visible()) {
                    shape.rectangle = aarectanglei{shape.x(), 0, shape.width(), layout.height()};
                }
            }
 
            cell.value->set_layout(context.transform(shape, 0.0f));
        }
    }
 
    void draw(widget_draw_context const& context) noexcept override
    {
        if (*mode > widget_mode::invisible) {
            for (hilet& cell : _grid) {
                cell.value->draw(context);
            }
        }
    }
 
    [[nodiscard]] hitbox hitbox_test(point2i position) const noexcept override
    {
        hi_axiom(loop::main().on_thread());
 
        if (*mode >= widget_mode::partial) {
            auto r = _aperture->hitbox_test_from_parent(position);
            r = _horizontal_bar->hitbox_test_from_parent(position, r);
            r = _vertical_bar->hitbox_test_from_parent(position, r);
 
            if (layout.contains(position)) {
                r = std::max(r, hitbox{id, layout.elevation});
            }
            return r;
 
        } else {
            return {};
        }
    }
    // @endprivatesection
private:
    grid_layout<std::unique_ptr<widget>> _grid;
 
    aperture_type *_aperture;
    horizontal_bar_type *_horizontal_bar;
    vertical_bar_type *_vertical_bar;
};
 
template<fixed_string Name = "">
using vertical_scroll_widget = scroll_widget<axis::vertical, Name>;
 
template<fixed_string Name = "">
using horizontal_scroll_widget = scroll_widget<axis::horizontal, Name>;
 
}} // namespace hi::v1