llradiogroup.h

Go to the documentation of this file.

#ifndef LL_LLRADIOGROUP_H
#define LL_LLRADIOGROUP_H

#include "lluictrl.h"
#include "llcheckboxctrl.h"
#include "llctrlselectioninterface.h"


/*
 * A checkbox control with use_radio_style == true.
 */
class LLRadioCtrl : public LLCheckBoxCtrl 
{
public:
        LLRadioCtrl(const LLString& name, const LLRect& rect, const LLString& label, const LLFontGL* font = NULL,
                void (*commit_callback)(LLUICtrl*, void*) = NULL, void* callback_userdata = NULL) :
                                LLCheckBoxCtrl(name, rect, label, font, commit_callback, callback_userdata, FALSE, RADIO_STYLE)
        {
                setTabStop(FALSE);
        }
        /*virtual*/ ~LLRadioCtrl();

        /*virtual*/ void setValue(const LLSD& value);
};


/*
 * An invisible view containing multiple mutually exclusive toggling 
 * buttons (usually radio buttons).  Automatically handles the mutex
 * condition by highlighting only one button at a time.
 */
class LLRadioGroup
:       public LLUICtrl, public LLCtrlSelectionInterface
{
public:
        // Build a radio group.  The number (0...n-1) of the currently selected
        // element will be stored in the named control.  After the control is
        // changed the callback will be called.
        LLRadioGroup(const LLString& name, const LLRect& rect, 
                const LLString& control_name, 
                LLUICtrlCallback callback = NULL,
                void* userdata = NULL,
                BOOL border = TRUE);

        // Another radio group constructor, but this one doesn't rely on
        // needing a control
        LLRadioGroup(const LLString& name, const LLRect& rect,
                                 S32 initial_index,
                                 LLUICtrlCallback callback = NULL,
                                 void* userdata = NULL,
                                 BOOL border = TRUE);

        virtual ~LLRadioGroup();

        virtual BOOL handleKeyHere(KEY key, MASK mask);

        virtual void setEnabled(BOOL enabled);
        virtual LLXMLNodePtr getXML(bool save_children = true) const;
        static LLView* fromXML(LLXMLNodePtr node, LLView *parent, LLUICtrlFactory *factory);
        void setIndexEnabled(S32 index, BOOL enabled);
        
        // return the index value of the selected item
        S32 getSelectedIndex() const { return mSelectedIndex; }
        
        // set the index value programatically
        BOOL setSelectedIndex(S32 index, BOOL from_event = FALSE);

        // Accept and retrieve strings of the radio group control names
        virtual void    setValue(const LLSD& value );
        virtual LLSD    getValue() const;

        // Draw the group, but also fix the highlighting based on the control.
        void draw();

        // You must use this method to add buttons to a radio group.
        // Don't use addChild -- it won't set the callback function
        // correctly.
        LLRadioCtrl* addRadioButton(const LLString& name, const LLString& label, const LLRect& rect, const LLFontGL* font);
        LLRadioCtrl* getRadioButton(const S32& index) { return mRadioButtons[index]; }
        // Update the control as needed.  Userdata must be a pointer to the button.
        static void onClickButton(LLUICtrl* radio, void* userdata);
        
        //========================================================================
        LLCtrlSelectionInterface* getSelectionInterface()       { return (LLCtrlSelectionInterface*)this; };

        // LLCtrlSelectionInterface functions
        /*virtual*/ S32         getItemCount() const                            { return mRadioButtons.size(); }
        /*virtual*/ BOOL        getCanSelect() const                            { return TRUE; }
        /*virtual*/ BOOL        selectFirstItem()                                       { return setSelectedIndex(0); }
        /*virtual*/ BOOL        selectNthItem( S32 index )                      { return setSelectedIndex(index); }
        /*virtual*/ BOOL        selectItemRange( S32 first, S32 last ) { return setSelectedIndex(first); }
        /*virtual*/ S32         getFirstSelectedIndex() const           { return getSelectedIndex(); }
        /*virtual*/ BOOL        setCurrentByID( const LLUUID& id );
        /*virtual*/ LLUUID      getCurrentID() const;                           // LLUUID::null if no items in menu
        /*virtual*/ BOOL        setSelectedByValue(const LLSD& value, BOOL selected);
        /*virtual*/ LLSD        getSelectedValue();
        /*virtual*/ BOOL        isSelected(const LLSD& value) const;
        /*virtual*/ BOOL        operateOnSelection(EOperation op);
        /*virtual*/ BOOL        operateOnAll(EOperation op);

private:
        // protected function shared by the two constructors.
        void init(BOOL border);

        S32 mSelectedIndex;
        typedef std::vector<LLRadioCtrl*> button_list_t;
        button_list_t mRadioButtons;

        BOOL mHasBorder;
};


#endif

---