Thumb.h

/***********************************************************************
        created:        25/4/2004
        author:         Paul D Turner
        
        purpose:        Interface for a 'Thumb' widget.  Intended to be used as
                                part of other widgets such as scrollers and sliders.
*************************************************************************/
/***************************************************************************
 *   Copyright (C) 2004 - 2006 Paul D Turner & The CEGUI Development Team
 *
 *   Permission is hereby granted, free of charge, to any person obtaining
 *   a copy of this software and associated documentation files (the
 *   "Software"), to deal in the Software without restriction, including
 *   without limitation the rights to use, copy, modify, merge, publish,
 *   distribute, sublicense, and/or sell copies of the Software, and to
 *   permit persons to whom the Software is furnished to do so, subject to
 *   the following conditions:
 *
 *   The above copyright notice and this permission notice shall be
 *   included in all copies or substantial portions of the Software.
 *
 *   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 *   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 *   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 *   IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
 *   OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 *   ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 *   OTHER DEALINGS IN THE SOFTWARE.
 ***************************************************************************/
#ifndef _CEGUIThumb_h_
#define _CEGUIThumb_h_

#include "./PushButton.h"
#include <utility>


#if defined(_MSC_VER)
#       pragma warning(push)
#       pragma warning(disable : 4251)
#       pragma warning(disable : 4996)
#endif


// Start of CEGUI namespace section
namespace CEGUI
{

class CEGUIEXPORT Thumb : public PushButton
{
public:
        static const String EventNamespace;                             
    static const String WidgetTypeName;             

        /*************************************************************************
                Event name constants
        *************************************************************************/
        // generated internally by Window
        static const String EventThumbPositionChanged;
        static const String EventThumbTrackStarted;
        static const String EventThumbTrackEnded;


        /*************************************************************************
                Accessor Functions
        *************************************************************************/ 
        bool    isHotTracked(void) const                        {return d_hotTrack;}

        bool    isVertFree(void) const                          {return d_vertFree;}

        bool    isHorzFree(void) const                          {return d_horzFree;}


        std::pair<float, float> getVertRange(void) const;


        std::pair<float, float> getHorzRange(void) const;


        /*************************************************************************
                Manipulator Functions
        *************************************************************************/
        void    setHotTracked(bool setting)                             {d_hotTrack = setting;}


        void    setVertFree(bool setting)                                               {d_vertFree = setting;}


        void    setHorzFree(bool setting)                                               {d_horzFree = setting;}
        

        void    setVertRange(float min, float max);

        void    setVertRange(const std::pair<float, float> &range);


        void    setHorzRange(float min, float max);
        void    setHorzRange(const std::pair<float, float> &range);


        /*************************************************************************
                Construction / Destruction
        *************************************************************************/
        Thumb(const String& type, const String& name);


        virtual ~Thumb(void);


protected:
    // overridden from base class
    void banPropertiesForAutoWindow();

        /*************************************************************************
                New Thumb Events
        *************************************************************************/
        virtual void    onThumbPositionChanged(WindowEventArgs& e);


        virtual void    onThumbTrackStarted(WindowEventArgs& e);


        virtual void    onThumbTrackEnded(WindowEventArgs& e);



        /*************************************************************************
                Overridden event handling routines
        *************************************************************************/
        virtual void    onMouseMove(MouseEventArgs& e);
        virtual void    onMouseButtonDown(MouseEventArgs& e);
        virtual void    onCaptureLost(WindowEventArgs& e);


        /*************************************************************************
                Implementation Data
        *************************************************************************/
        // general settings
        bool    d_hotTrack;                                     
        bool    d_vertFree;                                     
        bool    d_horzFree;                                     

        // operational limits
        float   d_vertMin, d_vertMax;           
        float   d_horzMin, d_horzMax;           

        // internal state
        bool    d_beingDragged;                         
        Vector2f d_dragPoint;                           


private:
        /*************************************************************************
                Private methods
        *************************************************************************/
        void    addThumbProperties(void);
};

/*
TODO: This is horrible, PropertyHelper for std::pair<float, float> would be fine but enforcing min: %f max: %f is just horrible
*/
template<>
class PropertyHelper<std::pair<float,float> >
{
public:
    typedef std::pair<float,float> return_type;
    typedef return_type safe_method_return_type;
    typedef const std::pair<float,float>& pass_type;
    typedef String string_return_type;

    static const String& getDataTypeName()
    {
        static String type("std::pair<float,float>");

        return type;
    }

    static return_type fromString(const String& str)
    {
        float rangeMin = 0, rangeMax = 0;
        sscanf(str.c_str(), " min:%f max:%f", &rangeMin, &rangeMax);
        return std::pair<float,float>(rangeMin,rangeMax);
    }

    static string_return_type toString(pass_type val)
    {
        char buff[64];
        sprintf(buff, "min:%f max:%f", val.first, val.second);
        return buff;
    }
};

} // End of  CEGUI namespace section

#if defined(_MSC_VER)
#       pragma warning(pop)
#endif

#endif  // end of guard _CEGUIThumb_h_