list.h

/*
 * Copyright (C) 2018 Microchip Technology Inc.  All rights reserved.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
#ifndef EGT_LIST_H
#define EGT_LIST_H
 
#include <egt/detail/meta.h>
#include <egt/label.h>
#include <egt/signal.h>
#include <egt/sizer.h>
#include <egt/string.h>
#include <egt/view.h>
#include <egt/widget.h>
#include <string>
 
namespace egt
{
inline namespace v1
{
 
class EGT_API ListBox : public Widget
{
public:
 
    Signal<> on_selected_changed;
 
    Signal<size_t> on_selected;
 
    Signal<> on_items_changed;
    using ItemArray = std::vector<std::shared_ptr<StringItem>>;
 
    explicit ListBox(const ItemArray& items = ItemArray()) noexcept;
 
    explicit ListBox(const Rect& rect) noexcept;
 
    ListBox(const ItemArray& items, const Rect& rect) noexcept;
 
    explicit ListBox(Frame& parent, const ItemArray& items = {}, const Rect& rect = {}) noexcept;
 
    explicit ListBox(Serializer::Properties& props) noexcept
        : ListBox(props, false)
    {
    }
 
protected:
 
    explicit ListBox(Serializer::Properties& props, bool is_derived) noexcept;
 
public:
 
    void handle(Event& event) override;
 
    void resize(const Size& s) override
    {
        if (s != size())
        {
            Widget::resize(s);
            auto carea = content_area();
            if (!carea.empty())
            {
                m_view.box(to_subordinate(carea));
                m_sizer.resize(carea.size());
            }
        }
    }
 
    void selected(size_t index);
 
    EGT_NODISCARD ssize_t selected() const;
 
    EGT_NODISCARD size_t item_count() const { return m_sizer.count_children(); }
 
    void add_item(const std::shared_ptr<StringItem>& item);
 
    void add_item(StringItem& item)
    {
        // Nasty, but it gets the job done.  If a widget is passed in as a
        // reference, we don't own it, so create a "pointless" shared_ptr that
        // will not delete it.
        auto i = std::shared_ptr<StringItem>(&item, [](StringItem*) {});
        add_item(i);
    }
 
    EGT_NODISCARD std::shared_ptr<StringItem> item_at(size_t index) const;
 
    void remove_item(StringItem* item);
 
    void clear();
 
    void scroll_top();
 
    void scroll_bottom();
 
    void scroll_beginning();
 
    void scroll_end();
 
    void orient(Orientation orient);
 
    EGT_NODISCARD Orientation orient() const
    {
        return m_orient;
    }
 
    void serialize(Serializer& serializer) const override;
 
protected:
 
    ScrolledView m_view;
 
    BoxSizer m_sizer;
 
    Orientation m_orient{Orientation::vertical};
 
private:
 
    void add_item_private(const std::shared_ptr<StringItem>& item);
 
    void deserialize(Serializer::Properties& props);
};
 
}
}
 
#endif