ComboBox.hpp

//
// TGUI - Texus's Graphical User Interface
// Copyright (C) 2012 Bruno Van de Velde (VDV_B@hotmail.com)
//
// This software is provided 'as-is', without any express or implied warranty.
// In no event will the authors be held liable for any damages arising from the use of this software.
//
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it freely,
// subject to the following restrictions:
//
// 1. The origin of this software must not be misrepresented;
//    you must not claim that you wrote the original software.
//    If you use this software in a product, an acknowledgment
//    in the product documentation would be appreciated but is not required.
//
// 2. Altered source versions must be plainly marked as such,
//    and must not be misrepresented as being the original software.
//
// 3. This notice may not be removed or altered from any source distribution.
//


#ifndef _TGUI_COMBO_BOX_INCLUDED_
#define _TGUI_COMBO_BOX_INCLUDED_


namespace tgui
{

    struct TGUI_API ComboBox : public OBJECT, OBJECT_BORDERS
    {
        ComboBox();


        ComboBox(const ComboBox& copy);


        virtual ~ComboBox();


        ComboBox& operator= (const ComboBox& right);


        virtual void initialize();


        virtual ComboBox* clone();


        virtual bool load(const std::string& comboBoxPathname,
                          float width,
                          float height,
                          unsigned int nrOfItemsInListToDisplay = 10,
                          const std::string& scrollbarPathname = "");


        virtual void setSize(float width, float height);


        virtual Vector2u getSize() const;


        virtual Vector2f getScaledSize() const;


        virtual std::string getLoadedPathname() const;


        virtual std::string getLoadedScrollbarPathname() const;


        virtual void setItemsToDisplay(unsigned int nrOfItemsInListToDisplay);

        virtual unsigned int getItemsToDisplay() const;


        virtual void changeColors(const sf::Color& backgroundColor         = sf::Color::White,
                                  const sf::Color& textColor               = sf::Color::Black,
                                  const sf::Color& selectedBackgroundColor = sf::Color(50, 100, 200),
                                  const sf::Color& selectedTextColor       = sf::Color::White,
                                  const sf::Color& borderColor             = sf::Color::Black);

        virtual void setBackgroundColor(const sf::Color& backgroundColor);

        virtual void setTextColor(const sf::Color& textColor);

        virtual void setSelectedBackgroundColor(const sf::Color& selectedBackgroundColor);

        virtual void setSelectedTextColor(const sf::Color& selectedTextColor);

        virtual void setBorderColor(const sf::Color& borderColor);


        virtual const sf::Color& getBackgroundColor() const;

        virtual const sf::Color& getTextColor() const;

        virtual const sf::Color& getSelectedBackgroundColor() const;

        virtual const sf::Color& getSelectedTextColor() const;

        virtual const sf::Color& getBorderColor() const;


        virtual void setTextFont(const sf::Font& font);

        virtual const sf::Font* getTextFont() const;


        virtual void setBorders(unsigned int leftBorder   = 0,
                                unsigned int topBorder    = 0,
                                unsigned int rightBorder  = 0,
                                unsigned int bottomBorder = 0);


        virtual unsigned int addItem(const sf::String& itemName);


        virtual bool setSelectedItem(const sf::String& itemName);

        virtual bool setSelectedItem(unsigned int id);


        virtual void removeItem(unsigned int id);


        virtual void removeItem(const sf::String& itemName);


        virtual void removeAllItems();


        virtual sf::String getItem(unsigned int id) const;


        virtual unsigned int getItemID(const sf::String& itemName) const;


        virtual std::vector<sf::String>& getItems() const;


        virtual sf::String getSelectedItem() const;


        virtual unsigned int getSelectedItemID() const;


        virtual bool setScrollbar(const std::string& scrollbarPathname);


        virtual void removeScrollbar();


        virtual void setMaximumItems(unsigned int maximumItems = 0);

        virtual unsigned int getMaximumItems() const;


        // These functions are used to receive callback from EventManager.
        // You normally don't need them, but you can use them to simulate an event.
        virtual bool mouseOnObject(float x, float y);
        virtual void leftMousePressed(float x, float y);
        virtual void leftMouseReleased(float x, float y);
        virtual void mouseMoved(float x, float y);
        virtual void mouseWheelMoved(int delta);
        virtual void mouseNoLongerDown();


    protected:


        // Because this struct is derived from sf::Drawable, you can just call the Draw function from your sf::RenderTarget.
        // This function will be called and it will draw the object on the render target.
        virtual void draw(sf::RenderTarget& target, sf::RenderStates states) const;


    protected:

        // This boolean becomes true when you clicked on the combo box, when the list should be shown
        bool m_ShowList;

        // When the mouse is on top of the object, it might be on the list box part.
        bool m_MouseOnListBox;

        // The number of items to display. If there is a scrollbar then you can scroll to see the other.
        // If there is no scrollbar then this will be the maximum amount of items.
        unsigned int m_NrOfItemsToDisplay;

        // Internally a list box is used to store all items
        ListBox*     m_ListBox;

        // The pathname of the loaded scrollbar (if there is one)
        std::string  m_LoadedScrollbarPathname;

        // The textures for the arrow image
        sf::Texture* m_TextureNormal;
        sf::Texture* m_TextureHover;

        // The sprites for the arrow image
        sf::Sprite   m_SpriteNormal;
        sf::Sprite   m_SpriteHover;

        // The pathname that was used to load the combo box
        std::string  m_LoadedPathname;

    };

}


#endif //_TGUI_COMBO_BOX_INCLUDED_