/*************************************************************************** * Copyright (C) 2008-2021 by Andrzej Rybczak * * andrzej@rybczak.net * * * * This program is free software; you can redistribute it and/or modify * * it under the terms of the GNU General Public License as published by * * the Free Software Foundation; either version 2 of the License, or * * (at your option) any later version. * * * * This program is distributed in the hope that it will be useful, * * but WITHOUT ANY WARRANTY; without even the implied warranty of * * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * * GNU General Public License for more details. * * * * You should have received a copy of the GNU General Public License * * along with this program; if not, write to the * * Free Software Foundation, Inc., * * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. * ***************************************************************************/ #ifndef NCMPCPP_MENU_H #define NCMPCPP_MENU_H #include #include #include #include #include #include #include #include "curses/formatted_color.h" #include "curses/strbuffer.h" #include "curses/window.h" #include "utility/const.h" namespace NC { struct List { struct Properties { enum Type { None = 0, Selectable = (1 << 0), Selected = (1 << 1), Inactive = (1 << 2), Separator = (1 << 3) }; Properties(Type properties = Selectable) : m_properties(properties) { } void setSelectable(bool is_selectable) { if (is_selectable) m_properties |= Selectable; else m_properties &= ~(Selectable | Selected); } void setSelected(bool is_selected) { if (!isSelectable()) return; if (is_selected) m_properties |= Selected; else m_properties &= ~Selected; } void setInactive(bool is_inactive) { if (is_inactive) m_properties |= Inactive; else m_properties &= ~Inactive; } void setSeparator(bool is_separator) { if (is_separator) m_properties |= Separator; else m_properties &= ~Separator; } bool isSelectable() const { return m_properties & Selectable; } bool isSelected() const { return m_properties & Selected; } bool isInactive() const { return m_properties & Inactive; } bool isSeparator() const { return m_properties & Separator; } private: unsigned m_properties; }; template using PropertiesIterator = boost::range_detail::any_iterator< ValueT, boost::random_access_traversal_tag, ValueT &, std::ptrdiff_t >; typedef PropertiesIterator Iterator; typedef PropertiesIterator ConstIterator; virtual ~List() { } virtual bool empty() const = 0; virtual size_t size() const = 0; virtual size_t choice() const = 0; virtual void highlight(size_t pos) = 0; virtual Iterator currentP() = 0; virtual ConstIterator currentP() const = 0; virtual Iterator beginP() = 0; virtual ConstIterator beginP() const = 0; virtual Iterator endP() = 0; virtual ConstIterator endP() const = 0; }; inline List::Properties::Type operator|(List::Properties::Type lhs, List::Properties::Type rhs) { return List::Properties::Type(unsigned(lhs) | unsigned(rhs)); } inline List::Properties::Type &operator|=(List::Properties::Type &lhs, List::Properties::Type rhs) { lhs = lhs | rhs; return lhs; } inline List::Properties::Type operator&(List::Properties::Type lhs, List::Properties::Type rhs) { return List::Properties::Type(unsigned(lhs) & unsigned(rhs)); } inline List::Properties::Type &operator&=(List::Properties::Type &lhs, List::Properties::Type rhs) { lhs = lhs & rhs; return lhs; } // for range-based for loop inline List::Iterator begin(List &list) { return list.beginP(); } inline List::ConstIterator begin(const List &list) { return list.beginP(); } inline List::Iterator end(List &list) { return list.endP(); } inline List::ConstIterator end(const List &list) { return list.endP(); } /// Generic menu capable of holding any std::vector compatible values. template struct Menu: Window, List { struct Item { friend struct Menu; typedef ItemT Type; Item() : m_impl(std::make_shared>()) { } template Item(ValueT &&value_, PropertiesT properties_) : m_impl( std::make_shared>( std::forward(value_), std::forward(properties_))) { } ItemT &value() { return std::get<0>(*m_impl); } const ItemT &value() const { return std::get<0>(*m_impl); } Properties &properties() { return std::get<1>(*m_impl); } const Properties &properties() const { return std::get<1>(*m_impl); } // Forward methods to List::Properties. void setSelectable(bool is_selectable) { properties().setSelectable(is_selectable); } void setSelected (bool is_selected) { properties().setSelected(is_selected); } void setInactive (bool is_inactive) { properties().setInactive(is_inactive); } void setSeparator (bool is_separator) { properties().setSeparator(is_separator); } bool isSelectable() const { return properties().isSelectable(); } bool isSelected() const { return properties().isSelected(); } bool isInactive() const { return properties().isInactive(); } bool isSeparator() const { return properties().isSeparator(); } // Make a deep copy of Item. Item copy() const { return Item(value(), properties()); } private: template struct ExtractProperties { typedef ExtractProperties type; typedef typename std::conditional< const_ == Const::Yes, const Properties, Properties>::type Properties_; typedef typename std::conditional< const_ == Const::Yes, const Item, Item>::type Item_; Properties_ &operator()(Item_ &i) const { return i.properties(); } }; template struct ExtractValue { typedef ExtractValue type; typedef typename std::conditional< const_ == Const::Yes, const ItemT, ItemT>::type Value_; typedef typename std::conditional< const_ == Const::Yes, const Item, Item>::type Item_; Value_ &operator()(Item_ &i) const { return i.value(); } }; static Item mkSeparator() { Item item; item.setSelectable(false); item.setSeparator(true); return item; } std::shared_ptr> m_impl; }; typedef typename std::vector::iterator Iterator; typedef typename std::vector::const_iterator ConstIterator; typedef std::reverse_iterator ReverseIterator; typedef std::reverse_iterator ConstReverseIterator; typedef boost::transform_iterator< typename Item::template ExtractValue, Iterator> ValueIterator; typedef boost::transform_iterator< typename Item::template ExtractValue, ConstIterator> ConstValueIterator; typedef std::reverse_iterator ReverseValueIterator; typedef std::reverse_iterator ConstReverseValueIterator; typedef boost::transform_iterator< typename Item::template ExtractProperties, Iterator> PropertiesIterator; typedef boost::transform_iterator< typename Item::template ExtractProperties, ConstIterator> ConstPropertiesIterator; // For compliance with boost utilities. typedef Iterator iterator; typedef ConstIterator const_iterator; /// Function helper prototype used to display each option on the screen. /// If not set by setItemDisplayer(), menu won't display anything. /// @see setItemDisplayer() typedef std::function &)> ItemDisplayer; typedef std::function FilterPredicate; Menu(); Menu(size_t startx, size_t starty, size_t width, size_t height, const std::string &title, Color color, Border border); Menu(const Menu &rhs); Menu(Menu &&rhs); Menu &operator=(Menu rhs); /// Sets helper function that is responsible for displaying items /// @param ptr function pointer that matches the ItemDisplayer prototype template void setItemDisplayer(ItemDisplayerT &&displayer); /// Resizes the list to given size (adequate to std::vector::resize()) /// @param size requested size void resizeList(size_t new_size); /// Adds a new option to list void addItem(ItemT item, Properties::Type properties = Properties::Selectable); /// Adds separator to list void addSeparator(); /// Inserts a new option to the list at given position void insertItem(size_t pos, ItemT item, Properties::Type properties = Properties::Selectable); /// Inserts separator to list at given position /// @param pos initial position of inserted separator void insertSeparator(size_t pos); /// Moves the highlighted position to the given line of window /// @param y Y position of menu window to be highlighted /// @return true if the position is reachable, false otherwise bool Goto(size_t y); /// Checks if list is empty /// @return true if list is empty, false otherwise virtual bool empty() const override { return m_items->empty(); } /// @return size of the list virtual size_t size() const override { return m_items->size(); } /// @return currently highlighted position virtual size_t choice() const override; /// Highlights given position /// @param pos position to be highlighted virtual void highlight(size_t position) override; /// Refreshes the menu window /// @see Window::refresh() virtual void refresh() override; /// Scrolls by given amount of lines /// @param where indicated where exactly one wants to go /// @see Window::scroll() virtual void scroll(Scroll where) override; /// Cleares all options, used filters etc. It doesn't reset highlighted position though. /// @see reset() virtual void clear() override; /// Sets highlighted position to 0 void reset(); /// Apply filter predicate to items in the menu and show the ones for which it /// returned true. template void applyFilter(PredicateT &&pred); /// Reapply previously applied filter. void reapplyFilter(); /// Get current filter predicate. template const TargetT *filterPredicate() const; /// Clear results of applyFilter and show all items. void clearFilter(); /// @return true if menu is filtered. bool isFiltered() const { return m_items == &m_filtered_items; } /// Show all items. void showAllItems() { m_items = &m_all_items; } /// Show filtered items. void showFilteredItems() { m_items = &m_filtered_items; } /// Sets prefix, that is put before each selected item to indicate its selection /// Note that the passed variable is not deleted along with menu object. /// @param b pointer to buffer that contains the prefix void setSelectedPrefix(const Buffer &b) { m_selected_prefix = b; } /// Sets suffix, that is put after each selected item to indicate its selection /// Note that the passed variable is not deleted along with menu object. /// @param b pointer to buffer that contains the suffix void setSelectedSuffix(const Buffer &b) { m_selected_suffix = b; } void setHighlightPrefix(const Buffer &b) { m_highlight_prefix = b; } void setHighlightSuffix(const Buffer &b) { m_highlight_suffix = b; } const Buffer &highlightPrefix() const { return m_highlight_prefix; } const Buffer &highlightSuffix() const { return m_highlight_suffix; } /// @return state of highlighting bool isHighlighted() { return m_highlight_enabled; } /// Turns on/off highlighting /// @param state state of hihglighting void setHighlighting(bool state) { m_highlight_enabled = state; } /// Turns on/off cyclic scrolling /// @param state state of cyclic scrolling void cyclicScrolling(bool state) { m_cyclic_scroll_enabled = state; } /// Turns on/off centered cursor /// @param state state of centered cursor void centeredCursor(bool state) { m_autocenter_cursor = state; } /// @return currently drawn item. The result is defined only within /// drawing function that is called by refresh() /// @see refresh() ConstIterator drawn() const { return begin() + m_drawn_position; } /// @param pos requested position /// @return reference to item at given position /// @throw std::out_of_range if given position is out of range Menu::Item &at(size_t pos) { return m_items->at(pos); } /// @param pos requested position /// @return const reference to item at given position /// @throw std::out_of_range if given position is out of range const Menu::Item &at(size_t pos) const { return m_items->at(pos); } /// @param pos requested position /// @return const reference to item at given position const Menu::Item &operator[](size_t pos) const { return (*m_items)[pos]; } /// @param pos requested position /// @return const reference to item at given position Menu::Item &operator[](size_t pos) { return (*m_items)[pos]; } Iterator current() { return Iterator(m_items->begin() + m_highlight); } ConstIterator current() const { return ConstIterator(m_items->begin() + m_highlight); } ReverseIterator rcurrent() { if (empty()) return rend(); else return ReverseIterator(++current()); } ConstReverseIterator rcurrent() const { if (empty()) return rend(); else return ConstReverseIterator(++current()); } ValueIterator currentV() { return ValueIterator(m_items->begin() + m_highlight); } ConstValueIterator currentV() const { return ConstValueIterator(m_items->begin() + m_highlight); } ReverseValueIterator rcurrentV() { if (empty()) return rendV(); else return ReverseValueIterator(++currentV()); } ConstReverseValueIterator rcurrentV() const { if (empty()) return rendV(); else return ConstReverseValueIterator(++currentV()); } Iterator begin() { return Iterator(m_items->begin()); } ConstIterator begin() const { return ConstIterator(m_items->begin()); } Iterator end() { return Iterator(m_items->end()); } ConstIterator end() const { return ConstIterator(m_items->end()); } ReverseIterator rbegin() { return ReverseIterator(end()); } ConstReverseIterator rbegin() const { return ConstReverseIterator(end()); } ReverseIterator rend() { return ReverseIterator(begin()); } ConstReverseIterator rend() const { return ConstReverseIterator(begin()); } ValueIterator beginV() { return ValueIterator(begin()); } ConstValueIterator beginV() const { return ConstValueIterator(begin()); } ValueIterator endV() { return ValueIterator(end()); } ConstValueIterator endV() const { return ConstValueIterator(end()); } ReverseValueIterator rbeginV() { return ReverseValueIterator(endV()); } ConstReverseIterator rbeginV() const { return ConstReverseValueIterator(endV()); } ReverseValueIterator rendV() { return ReverseValueIterator(beginV()); } ConstReverseValueIterator rendV() const { return ConstReverseValueIterator(beginV()); } virtual List::Iterator currentP() override { return List::Iterator(PropertiesIterator(m_items->begin() + m_highlight)); } virtual List::ConstIterator currentP() const override { return List::ConstIterator(ConstPropertiesIterator(m_items->begin() + m_highlight)); } virtual List::Iterator beginP() override { return List::Iterator(PropertiesIterator(m_items->begin())); } virtual List::ConstIterator beginP() const override { return List::ConstIterator(ConstPropertiesIterator(m_items->begin())); } virtual List::Iterator endP() override { return List::Iterator(PropertiesIterator(m_items->end())); } virtual List::ConstIterator endP() const override { return List::ConstIterator(ConstPropertiesIterator(m_items->end())); } private: bool isHighlightable(size_t pos) { return !(*m_items)[pos].isSeparator() && !(*m_items)[pos].isInactive(); } ItemDisplayer m_item_displayer; FilterPredicate m_filter_predicate; std::vector *m_items; std::vector m_all_items; std::vector m_filtered_items; size_t m_beginning; size_t m_highlight; bool m_highlight_enabled; bool m_cyclic_scroll_enabled; bool m_autocenter_cursor; size_t m_drawn_position; Buffer m_highlight_prefix; Buffer m_highlight_suffix; Buffer m_selected_prefix; Buffer m_selected_suffix; }; } #endif // NCMPCPP_MENU_H