TabWnd.h

Go to the documentation of this file.

// -*- C++ -*-
/* GG is a GUI for SDL and OpenGL.
   Copyright (C) 2006 T. Zachary Laine

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public License
   as published by the Free Software Foundation; either version 2.1
   of the License, or (at your option) any later version.
   
   This library 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
   Lesser General Public License for more details.
    
   You should have received a copy of the GNU Lesser General Public
   License along with this library; if not, write to the Free
   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
   02111-1307 USA

   If you do not wish to comply with the terms of the LGPL please
   contact the author as other terms are available for a fee.
    
   Zach Laine
   whatwasthataddress@hotmail.com */
   
#ifndef _GG_TabWnd_h_
#define _GG_TabWnd_h_

#include <GG/Button.h>


namespace GG {

class TabBar;
class WndEvent;

class GG_API TabWnd : public Wnd
{
public: 

    typedef boost::signal<void (int)> WndChangedSignalType;
 
    typedef WndChangedSignalType::slot_type WndChangedSlotType; 

 

    TabWnd(int x, int y, int w, int h, const boost::shared_ptr<Font>& font, Clr color, Clr text_color = CLR_BLACK,
           TabBarStyle style = TAB_BAR_ATTACHED, Flags<WndFlag> flags = CLICKABLE | DRAGABLE);
    ~TabWnd();
 
    virtual Pt MinUsableSize() const;

    Wnd* CurrentWnd() const;

    int  CurrentWndIndex() const;
 
    virtual void Render();

    int  AddWnd(Wnd* wnd, const std::string& name);

    void InsertWnd(int index, Wnd* wnd, const std::string& name);

    Wnd* RemoveWnd(const std::string& name);

    void SetCurrentWnd(int index);

    mutable WndChangedSignalType WndChangedSignal; 

    static const int NO_WND;

protected: 
    TabWnd(); 

 
    const TabBar*                                     GetTabBar() const;
    const std::vector<std::pair<Wnd*, std::string> >& Wnds() const;

private:
    void TabChanged(int tab_index);

    TabBar*                                    m_tab_bar;
    std::vector<std::pair<Wnd*, std::string> > m_wnds;
    Wnd*                                       m_current_wnd;

    friend class boost::serialization::access;
    template <class Archive>
    void serialize(Archive& ar, const unsigned int version);
};


class GG_API TabBar : public Control
{
public: 

    typedef boost::signal<void (int)> TabChangedSignalType;
 
    typedef TabChangedSignalType::slot_type TabChangedSlotType; 

 

    TabBar(int x, int y, int w, const boost::shared_ptr<Font>& font, Clr color, Clr text_color = CLR_BLACK,
           TabBarStyle style = TAB_BAR_ATTACHED, Flags<WndFlag> flags = CLICKABLE);
 
    virtual Pt MinUsableSize() const;

    int CurrentTabIndex() const;
 
    virtual void SizeMove(const Pt& ul, const Pt& lr);
    virtual void Render();

    int  AddTab(const std::string& name);

    void InsertTab(int index, const std::string& name);

    void RemoveTab(const std::string& name);

    void SetCurrentTab(int index);

    mutable TabChangedSignalType TabChangedSignal; 

    static const int NO_TAB;

    static const int BUTTON_WIDTH;

protected: 
    TabBar(); 

 
    const Button* LeftButton() const;
    const Button* RightButton() const;
 
    virtual bool EventFilter(Wnd* w, const WndEvent& event);

private:
    virtual void DistinguishCurrentTab(const std::vector<StateButton*>& tab_buttons);

    void TabChanged(int index);
    void LeftClicked();
    void RightClicked();
    void BringTabIntoView(int index);

    RadioButtonGroup*         m_tabs;
    std::vector<StateButton*> m_tab_buttons;
    boost::shared_ptr<Font>   m_font;
    Button*                   m_left_button;
    Button*                   m_right_button;
    Layout*                   m_left_right_button_layout;
    Flags<TextFormat>         m_format;
    Clr                       m_text_color;
    TabBarStyle               m_style;
    int                       m_first_tab_shown;

    friend class boost::serialization::access;
    template <class Archive>
    void serialize(Archive& ar, const unsigned int version);
};

} // namespace GG

// template implementations
template <class Archive>
void GG::TabWnd::serialize(Archive& ar, const unsigned int version)
{
    ar  & BOOST_SERIALIZATION_BASE_OBJECT_NVP(Wnd)
        & BOOST_SERIALIZATION_NVP(m_tab_bar)
        & BOOST_SERIALIZATION_NVP(m_wnds)
        & BOOST_SERIALIZATION_NVP(m_current_wnd);
}

template <class Archive>
void GG::TabBar::serialize(Archive& ar, const unsigned int version)
{
    ar  & BOOST_SERIALIZATION_BASE_OBJECT_NVP(Control)
        & BOOST_SERIALIZATION_NVP(m_tabs)
        & BOOST_SERIALIZATION_NVP(m_tab_buttons)
        & BOOST_SERIALIZATION_NVP(m_font)
        & BOOST_SERIALIZATION_NVP(m_left_button)
        & BOOST_SERIALIZATION_NVP(m_right_button)
        & BOOST_SERIALIZATION_NVP(m_left_right_button_layout)
        & BOOST_SERIALIZATION_NVP(m_format)
        & BOOST_SERIALIZATION_NVP(m_text_color)
        & BOOST_SERIALIZATION_NVP(m_style)
        & BOOST_SERIALIZATION_NVP(m_first_tab_shown);
}

#endif

---