ufilebox.hpp

/* ==================================================== ======== ======= *
 *
 *  ufilebox.hpp
 *  Ubit Project
 *  Part of the Ubit Toolkit: A Brick Construction Game Model for Creating GUIs
 *  (C) 1999-2006 / EricLecolinet / ENST Paris / http://www.enst.fr/~elc/ubit
 *
 * ***********************************************************************
 * COPYRIGHT NOTICE : 
 * THIS PROGRAM IS DISTRIBUTED WITHOUT ANY WARRANTY AND WITHOUT EVEN THE 
 * IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 
 * YOU CAN REDISTRIBUTE IT AND/OR MODIFY IT UNDER THE TERMS OF THE GNU 
 * GENERAL PUBLIC LICENSE AS PUBLISHED BY THE FREE SOFTWARE FOUNDATION; 
 * EITHER VERSION 2 OF THE LICENSE, OR (AT YOUR OPTION) ANY LATER VERSION.
 * SEE FILES 'COPYRIGHT' AND 'COPYING' FOR MORE DETAILS.
 * ***********************************************************************
 * ==================================================== [(c)Elc] ======= *
 * ==================================================== ======== ======= */

#ifndef _ufilebox_hpp_
#define _ufilebox_hpp_
#include <ubit/uchoice.hpp>
//pragma ident  "@(#)ufilebox.hpp       ubit:05.05.00"
namespace ubit {

/* ==================================================== ======== ======= */
/* File chooser.
* A UFilebox can be included into a UDialog or a UMenu as follows:
* examples:
* <pre>
*   class Demo {
*   public:
*     void openFile(UEvent& e) {...}   // the UEvent& parameter is optional
*     ...
*   };
*
*   Demo* d = new Demo();
*
*   // NB: ufilebox(...) is a shortcut for *new UFilebox(...)
*   UBox& fbox = ufilebox( utitle("Open File")
*                          + UOn::action / ucall(this, &Demo::openFile)
*                         );
*   UDialog& fdialog = udialog(fbox)
*   // and/or:
*   UMenu& fmenu = umenu(fbox)
* </pre>
*
* this->openFile() is called when a file is double clicked or when
* the OK button of the filebox is clicked.
*
* @see: UCall for more info on callback methods/functions and their parameters
*/
class UFilebox : public UBox {
public:
  UBIT_ELEMENT_CLASS(UFilebox, UBox)

  UFilebox(const UArgs& arglist = UArgs::none);
  friend UFilebox& ufilebox(const UArgs& arglist = UArgs::none);
  virtual ~UFilebox();

  // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

  const UStr& getDir() const {return *fdir2;}

  const UStr& getName() const {return *fname;}

  const UStr& getPath() const {return *fpath;}
  UStr& path() {return *fpath;}

  const UStr& getFilter() const {return *ffilter;}

  // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

  virtual void setDir(const UStr&);

  virtual void setName(const UStr&);

  virtual void setFilter(const UStr&);

  virtual void showList(bool);
  virtual void showHiddenFiles(bool);

  virtual void rescan();

  void setAutoClose(bool stat) {autoclose = stat;}
  
  // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
protected:
  UStr fspec;
  uptr<UStr> fname, fdir2, ffilter, fpath;
  UScrollpane* scrollpane;
  UBox *viewport, *show_list, *show_hidden_files;
  URadioSelect new_sel;
  bool autoclose;
  
  virtual void cancelBehavior(UEvent&);
  virtual void okBehavior(UEvent&);
  virtual void selectBehavior(UEvent&, const UStr* pathname);

  virtual void setDirImpl(const UStr*);
  virtual void changeDirImpl(const UStr*);
};

}
#endif
/* ==================================================== [TheEnd] ======= */
/* ==================================================== [(c)Elc] ======= */

---