openmw-tes3mp/apps/openmw/mwgui/list.hpp

#ifndef MWGUI_LIST_HPP
#define MWGUI_LIST_HPP

#include <MyGUI_ScrollView.h>

namespace MWGui
{
    namespace Widgets
    {
        /**
         * \brief a custom ScrollView which has access to scrollbar properties
         */
        class MWScrollView : public MyGUI::ScrollView
        {
            MYGUI_RTTI_DERIVED(MWScrollView)
        public:
            size_t getScrollPosition();
            void setScrollPosition(size_t);
            size_t getScrollRange();
        };

        /**
         * \brief a very simple list widget that supports word-wrapping entries
         * \note if the width or height of the list changes, you must call adjustSize() method
         */
        class MWList : public MyGUI::Widget
        {
            MYGUI_RTTI_DERIVED(MWList)
        public:
            MWList();

            typedef MyGUI::delegates::CMultiDelegate2<const std::string&, int> EventHandle_StringInt;
            typedef MyGUI::delegates::CMultiDelegate1<MyGUI::Widget*> EventHandle_Widget;

            /**
             * Event: Item selected with the mouse.
             * signature: void method(std::string itemName)
             */
            EventHandle_StringInt eventItemSelected;

            /**
             * Event: Item selected with the mouse.
             * signature: void method(MyGUI::Widget* sender)
             */
            EventHandle_Widget eventWidgetSelected;


            /**
             * Call after the size of the list changed, or items were inserted/removed
             */
            void adjustSize();

            void addItem(const std::string& name);
            void addSeparator(); ///< add a seperator between the current and the next item.
            void removeItem(const std::string& name);
            bool hasItem(const std::string& name);
            unsigned int getItemCount();
            std::string getItemNameAt(unsigned int at); ///< \attention if there are separators, this method will return "" at the place where the separator is
            void clear();

            MyGUI::Widget* getItemWidget(const std::string& name);
            ///< get widget for an item name, useful to set up tooltip

        protected:
            void initialiseOverride();

            void redraw(bool scrollbarShown = false);

            void onMouseWheel(MyGUI::Widget* _sender, int _rel);
            void onItemSelected(MyGUI::Widget* _sender);

        private:
            MWGui::Widgets::MWScrollView* mScrollView;
            MyGUI::Widget* mClient;

            std::vector<std::string> mItems;

            int mItemHeight; // height of all items
        };
    }
}

#endif