/*************************************************************************** * Copyright (C) 2008-2014 by Andrzej Rybczak * * electricityispower@gmail.com * * * * 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 "strbuffer.h" #include "window.h" namespace NC { /// This template class is generic menu capable of /// holding any std::vector compatible values. template class Menu : public Window { struct ItemProxy; public: struct Item { typedef ItemT Type; friend class Menu; Item() : m_is_bold(false), m_is_selected(false), m_is_inactive(false), m_is_separator(false) { } Item(ItemT value_, bool is_bold, bool is_inactive) : m_value(value_), m_is_bold(is_bold), m_is_selected(false), m_is_inactive(is_inactive), m_is_separator(false) { } ItemT &value() { return m_value; } const ItemT &value() const { return m_value; } ItemT &operator*() { return m_value; } const ItemT &operator*() const { return m_value; } void setBold(bool is_bold) { m_is_bold = is_bold; } void setSelected(bool is_selected) { m_is_selected = is_selected; } void setInactive(bool is_inactive) { m_is_inactive = is_inactive; } void setSeparator(bool is_separator) { m_is_separator = is_separator; } bool isBold() const { return m_is_bold; } bool isSelected() const { return m_is_selected; } bool isInactive() const { return m_is_inactive; } bool isSeparator() const { return m_is_separator; } private: static Item mkSeparator() { Item item; item.m_is_separator = true; return item; } ItemT m_value; bool m_is_bold; bool m_is_selected; bool m_is_inactive; bool m_is_separator; }; typedef boost::indirect_iterator< typename std::vector::iterator, Item, boost::random_access_traversal_tag > Iterator; typedef boost::indirect_iterator< typename std::vector::const_iterator, const Item, boost::random_access_traversal_tag > ConstIterator; typedef std::reverse_iterator ReverseIterator; typedef std::reverse_iterator ConstReverseIterator; typedef boost::indirect_iterator< Iterator, ItemT, boost::random_access_traversal_tag > ValueIterator; typedef boost::indirect_iterator< ConstIterator, const ItemT, boost::random_access_traversal_tag > ConstValueIterator; typedef std::reverse_iterator ReverseValueIterator; typedef std::reverse_iterator ConstReverseValueIterator; /// 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; 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 void setItemDisplayer(const ItemDisplayer &f) { m_item_displayer = f; } /// Resizes the list to given size (adequate to std::vector::resize()) /// @param size requested size void resizeList(size_t new_size); /// Adds new option to list /// @param item object that has to be added /// @param is_bold defines the initial state of bold attribute /// @param is_inactive defines the initial state of static attribute void addItem(ItemT item, bool is_bold = false, bool is_inactive = false); /// Adds separator to list void addSeparator(); /// Inserts new option to list at given position /// @param pos initial position of inserted item /// @param item object that has to be inserted /// @param is_bold defines the initial state of bold attribute /// @param is_inactive defines the initial state of static attribute void insertItem(size_t pos, const ItemT &Item, bool is_bold = false, bool is_inactive = false); /// Inserts separator to list at given position /// @param pos initial position of inserted separator void insertSeparator(size_t pos); /// Deletes item from given position /// @param pos given position of item to be deleted void deleteItem(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); /// Highlights given position /// @param pos position to be highlighted void highlight(size_t pos); /// @return currently highlighted position size_t choice() const; /// 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(); /// 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; } /// Sets custom color of highlighted position /// @param col custom color void setHighlightColor(Color color) { m_highlight_color = std::move(color); } /// @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; } /// Checks if list is empty /// @return true if list is empty, false otherwise bool empty() const { return m_items.empty(); } /// @return size of the list size_t size() const { return m_items.size(); } /// @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() { return ReverseIterator(++current()); } ConstReverseIterator rcurrent() const { return ReverseIterator(++current()); } ValueIterator currentV() { return ValueIterator(m_items.begin() + m_highlight); } ConstValueIterator currentV() const { return ConstValueIterator(m_items.begin() + m_highlight); } ReverseValueIterator rcurrentV() { return ReverseValueIterator(++currentV()); } ConstReverseValueIterator rcurrentV() const { 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()); } private: struct ItemProxy { typedef Item element_type; ItemProxy() { } ItemProxy(Item item) : m_ptr(std::make_shared(std::move(item))) { } Item &operator*() const { return *m_ptr; } Item *operator->() const { return m_ptr.get(); } bool operator==(const ItemProxy &rhs) const { return m_ptr == rhs.m_ptr; } private: std::shared_ptr m_ptr; }; bool isHighlightable(size_t pos) { return !m_items[pos]->isSeparator() && !m_items[pos]->isInactive(); } ItemDisplayer m_item_displayer; std::vector m_items; size_t m_beginning; size_t m_highlight; Color m_highlight_color; bool m_highlight_enabled; bool m_cyclic_scroll_enabled; bool m_autocenter_cursor; size_t m_drawn_position; Buffer m_selected_prefix; Buffer m_selected_suffix; }; } #endif // NCMPCPP_MENU_H