uilistbox.h

Go to the documentation of this file.

#ifndef uilistbox_h
#define uilistbox_h

/*+
________________________________________________________________________

 (C) dGB Beheer B.V.; (LICENSE) http://opendtect.org/OpendTect_license.txt
 Author:        Nanne Hemstra
 Date:          16/05/2000
 RCS:           $Id$
________________________________________________________________________

-*/

#include "uibasemod.h"
#include "uigroup.h"
#include "uistrings.h"
#include "keyenum.h"
#include "draw.h"

class BufferStringSet;
class uiCheckBox;
class uiLabel;
class uiListBoxBody;
class uiMenu;
class uiString;

mFDQtclass(QListWidgetItem)




mExpClass(uiBase) uiListBoxObj : public uiObject
{
public:
                        uiListBoxObj(uiParent*,const char* nm,OD::ChoiceMode);
                        ~uiListBoxObj();

    uiListBoxBody&      body()          { return *body_; }

private:
    uiListBoxBody*      body_;
    uiListBoxBody&      mkbody(uiParent*,const char*,OD::ChoiceMode);
};



mExpClass(uiBase) uiListBox : public uiGroup
{ mODTextTranslationClass(uiListBox)
friend class i_listMessenger;
friend class uiListBoxBody;
public:
   enum LblPos          { LeftTop, RightTop, LeftMid, RightMid,
                          AboveLeft, AboveMid, AboveRight,
                          BelowLeft, BelowMid, BelowRight };

    mExpClass(uiBase) Setup
    {
    public:
                        Setup(OD::ChoiceMode icm=OD::ChooseOnlyOne,
                              const uiString& l=uiStrings::sEmptyString(),
                              uiListBox::LblPos lp=uiListBox::LeftTop)
                            : lbl_(l)
                            , cm_(icm)
                            , prefnrlines_(0)
                            , prefwidth_(0)
                            , lblpos_(lp)
                            {}

        mDefSetupMemb(uiString,lbl)
        mDefSetupMemb(OD::ChoiceMode,cm)
        mDefSetupMemb(int,prefnrlines)
        mDefSetupMemb(int,prefwidth)
        mDefSetupMemb(uiListBox::LblPos,lblpos)

    };

                        uiListBox(uiParent*,const char* nm=0,
                                  OD::ChoiceMode cm=OD::ChooseOnlyOne);
                        uiListBox(uiParent*,const Setup&,const char* nm=0);
    virtual             ~uiListBox();

    uiListBoxObj*       box()                           { return lb_; }
    uiGroup*            checkGroup()                    { return checkgrp_; }
    uiCheckBox*         masterCheckBox()                { return cb_; }
    int                 nrLabels() const                { return lbls_.size(); }
    uiLabel*            label( int nr=0 )               { return lbls_[nr]; }
    void                setLabelText(const uiString&,int nr=0);

    inline OD::ChoiceMode choiceMode() const    { return choicemode_; }
    inline bool         isMultiChoice() const
                                        { return ::isMultiChoice(choicemode_); }
    void                setChoiceMode(OD::ChoiceMode);
    void                setMultiChoice(bool yn=true);
    void                setAllowNoneChosen(bool);
    void                setNotSelectable();

    int                 size() const;
    inline bool         isEmpty() const         { return size() == 0; }
    bool                validIdx(int) const;
    bool                isPresent(const char*) const;
    int                 maxNrOfChoices() const;

    Alignment::HPos     alignment() const       { return alignment_; }
    void                setAlignment(Alignment::HPos);
    void                setNrLines(int);
    void                setFieldWidth(int);
    void                setHSzPol(uiObject::SzPolicy);
    void                setVSzPol(uiObject::SzPolicy);

    void                setEmpty();
    void                removeItem(int);
    void                removeItem(const char*);
    void                removeItem( const FixedString& fs )
                                                { removeItem( fs.str() ); }
    void                setAllowDuplicates(bool yn);
    void                addItem(const uiString&,bool marked=false,int id=-1);
    void                addItem(const uiString&,const uiPixmap&,int id=-1);
    void                addItem(const uiString&,const Color&,int id=-1);
    void                addItems(const char**);
    void                addItems(const BufferStringSet&);
    void                addItems(const uiStringSet&);
    void                insertItem(const uiString&,int idx=-1,
                                   bool marked=false,int id=-1);
    void                insertItem(const uiString&,const uiPixmap&,
                                   int idx=-1,int id=-1);
    void                insertItem(const uiString&,const Color&,
                                   int idx=-1,int id=-1);
    void                setPixmap(int,const Color&);
    void                setPixmap(int,const uiPixmap&);
    void                setIcon(int,const char* icon_identifier);
    void                setColor(int,const Color&);
    Color               getColor(int) const;

    void                sortItems(bool asc=true);

    int                 indexOf(const char*) const;     
    const char*         textOfItem(int) const;
    void                setItemText(int,const uiString&);
    void                getItems(BufferStringSet&) const;

    int                 currentItem() const;
    const char*         getText() const  { return textOfItem(currentItem()); }
    void                setCurrentItem(int);
    void                setCurrentItem(const char*);    
    void                setCurrentItem( const FixedString& fs )
                                                { setCurrentItem( fs.str() ); }
    void                setItemSelectable(int,bool);

    int                 nrChosen() const;
    bool                isChoosable(int) const;
    bool                isChosen(int) const;
    int                 firstChosen() const;
    int                 nextChosen(int prev=-1) const;
    void                getChosen(BufferStringSet&) const;
    void                getChosen(TypeSet<int>&) const;
    void                setChoosable(int,bool yn);
    void                setChosen(int,bool yn=true);
    void                setChosen(Interval<int>,bool yn=true);
    void                chooseAll(bool yn=true);
    void                setChosen(const BufferStringSet&);
    void                setChosen(const TypeSet<int>&);

    bool                isMarked(int) const;
    void                setMarked(int,bool);

    void                setItemID(int idx,int id);
    int                 currentItemID() const;
    int                 getItemID(int idx) const;
    int                 getItemIdx(int id) const;       

    void                scrollToTop();
    void                scrollToBottom();
    bool                handleLongTabletPress();
    void                disableRightClick(bool yn);
    void                blockScrolling(bool yn) { scrollingblocked_ = yn; }

    Notifier<uiListBox> selectionChanged;
    CNotifier<uiListBox,int> itemChosen; /*< if itmidx==-1, many items were
                                                chosen at once */
    Notifier<uiListBox> doubleClicked;
    Notifier<uiListBox> rightButtonClicked;
    Notifier<uiListBox> leftButtonClicked;
    Notifier<uiListBox> deleteButtonPressed;

    void                offerReadWriteSelection( const CallBack& rcb,
                                                 const CallBack& wcb )
                        { retrievecb_ = rcb; savecb_ = wcb; }

private:

    void                translateText();

    OD::ChoiceMode      choicemode_;
    Alignment::HPos     alignment_;
    bool                allowduplicates_;
    uiMenu&             rightclickmnu_;
    mutable BufferString rettxt_;
    OD::ButtonState     buttonstate_;
    CallBack            savecb_;
    CallBack            retrievecb_;
    bool                scrollingblocked_;

    void                menuCB(CallBacker*);
    void                handleCheckChange(mQtclass(QListWidgetItem*));
    void                usrChooseAll(bool yn=true);

    bool                isNone() const  { return choicemode_ == OD::ChooseNone;}
    int                 optimumFieldWidth(int minwdth=20,int maxwdth=40) const;
    static int          cDefNrLines();          

    void                updateFields2ChoiceMode();
    void                initNewItem(int);
    void                setItemCheckable(int,bool);

    void                setItemsCheckable( bool yn )    { setMultiChoice(yn); }
    void                setAllItemsChecked(bool);
    void                setItemChecked(int,bool);
    void                setItemChecked(const char*,bool);
    bool                isItemChecked(const char*) const;
    int                 nrChecked() const;
    void                setCheckedItems(const BufferStringSet&);
    void                setCheckedItems(const TypeSet<int>&);
    void                getCheckedItems(BufferStringSet&) const;
    void                getCheckedItems(TypeSet<int>&) const;

protected:
    uiListBoxObj*       lb_;
    ObjectSet<uiLabel>  lbls_;
    uiGroup*            checkgrp_;
    uiCheckBox*         cb_;

    void                mkLabel(const uiString&,LblPos);
    void                mkCheckGroup();
    void                checkCB(CallBacker*);
    void                updateCheckState();
    void                addItemNoUpdate(const uiString&,bool marked=false,
                                                                    int id=-1);

public:
    bool                isItemChecked(int) const;

// Deprecated. Don't use in new code
                        uiListBox(uiParent*,const BufferStringSet&,
                                  const char* nm=0);
                        uiListBox(uiParent*,const BufferStringSet&,
                                  const char* nm,OD::ChoiceMode cm,
                                  int prefNrLines=0,int prefFieldWidth=0);
                        uiListBox(uiParent*,const uiStringSet&,
                                  const char* nm,OD::ChoiceMode cm,
                                  int prefNrLines=0,int prefFieldWidth=0);
};


mExpClass(uiBase) uiLabeledListBox : public uiListBox
{
public:

    enum LblPos         { LeftTop, RightTop, LeftMid, RightMid,
                          AboveLeft, AboveMid, AboveRight,
                          BelowLeft, BelowMid, BelowRight };

                        uiLabeledListBox(uiParent*,const uiString& lbltxt);
                        uiLabeledListBox(uiParent*,const uiString& lbltxt,
                                     OD::ChoiceMode,LblPos p=LeftMid);
                        uiLabeledListBox(uiParent*,const BufferStringSet&,
                                     const uiString& lbltxt,
                                     OD::ChoiceMode,LblPos p=LeftMid);

    uiListBox*          box()                           { return this; }

protected:

};


#endif