//// "$Id: Fl_Browser_.H 4288 2005-04-16 00:13:17Z mike $"//// Common browser header file for the Fast Light Tool Kit (FLTK).//// Copyright 1998-2005 by Bill Spitzak and others.//// This library is free software; you can redistribute it and/or// modify it under the terms of the GNU Library General Public// License as published by the Free Software Foundation; either// version 2 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// Library General Public License for more details.//// You should have received a copy of the GNU Library 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.//// Please report all bugs and problems on the following page:////     http://www.fltk.org/str.php//// This is the base class for browsers.  To be useful it must// be subclassed and several virtual functions defined.  The// Forms-compatable browser and the file chooser's browser are// subclassed off of this.// Yes, I know this should be a template...#ifndef Fl_Browser__H#define Fl_Browser__H#ifndef Fl_Group_H#include "Fl_Group.H"#endif#include "Fl_Scrollbar.H"#define FL_NORMAL_BROWSER	0#define FL_SELECT_BROWSER	1#define FL_HOLD_BROWSER		2#define FL_MULTI_BROWSER	3class FL_EXPORT Fl_Browser_ : public Fl_Group {  int position_;	// where user wants it scrolled to  int real_position_;	// the current vertical scrolling position  int hposition_;	// where user wants it panned to  int real_hposition_;	// the current horizontal scrolling position  int offset_;		// how far down top_ item the real_position is  int max_width;	// widest object seen so far  uchar has_scrollbar_;	// which scrollbars are enabled  uchar textfont_, textsize_;  unsigned textcolor_;  void* top_;		// which item scrolling position is in  void* selection_;	// which is selected (except for FL_MULTI_BROWSER)  void *redraw1,*redraw2; // minimal update pointers  void* max_width_item;	// which item has max_width_  static int scrollbar_width_;  void update_top();protected:  // All of the following must be supplied by the subclass:  virtual void *item_first() const = 0;  virtual void *item_next(void *) const = 0;  virtual void *item_prev(void *) const = 0;  virtual int item_height(void *) const = 0;  virtual int item_width(void *) const = 0;  virtual int item_quick_height(void *) const ;  virtual void item_draw(void *,int,int,int,int) const = 0;  // you don't have to provide these but it may help speed it up:  virtual int full_width() const ;	// current width of all items  virtual int full_height() const ;	// current height of all items  virtual int incr_height() const ;	// average height of an item  // These only need to be done by subclass if you want a multi-browser:  virtual void item_select(void *,int=1);  virtual int item_selected(void *) const ;  // things the subclass may want to call:  void *top() const {return top_;}  void *selection() const {return selection_;}  void new_list(); // completely clobber all data, as though list replaced  void deleting(void *a); // get rid of any pointers to a  void replacing(void *a,void *b); // change a pointers to b  void inserting(void *a,void *b); // insert b near a  int displayed(void *) const ; // true if this line is visible  void redraw_line(void *); // minimal update, no change in size  void redraw_lines() {damage(FL_DAMAGE_SCROLL);} // redraw all of them  void bbox(int&,int&,int&,int&) const;  int leftedge() const;	// x position after scrollbar & border  void *find_item(int my); // item under mouse  void draw(int,int,int,int);  int handle(int,int,int,int,int);  void draw();  Fl_Browser_(int,int,int,int,const char * = 0);public:  Fl_Scrollbar scrollbar;		// Vertical scrollbar  Fl_Scrollbar hscrollbar;		// Horizontal scrollbar  int handle(int);  void resize(int,int,int,int);  int select(void *,int=1,int docallbacks=0);  int select_only(void *,int docallbacks=0);  int deselect(int docallbacks=0);  int position() const {return position_;}  int hposition() const {return hposition_;}  void position(int); // scroll to here  void hposition(int); // pan to here  void display(void*); // scroll so this item is shown  uchar has_scrollbar() const {return has_scrollbar_;}  void has_scrollbar(uchar i) {has_scrollbar_ = i;}  enum { // values for has_scrollbar()    HORIZONTAL = 1,    VERTICAL = 2,    BOTH = 3,    ALWAYS_ON = 4,    HORIZONTAL_ALWAYS = 5,    VERTICAL_ALWAYS = 6,    BOTH_ALWAYS = 7  };  Fl_Font textfont() const {return (Fl_Font)textfont_;}  void textfont(uchar s) {textfont_ = s;}  uchar textsize() const {return textsize_;}  void textsize(uchar s) {textsize_ = s;}  Fl_Color textcolor() const {return (Fl_Color)textcolor_;}  void textcolor(unsigned n) {textcolor_ = n;}  static void scrollbar_width(int b) {scrollbar_width_ = b;}  static int scrollbar_width() {return scrollbar_width_;}  // for back compatability:  void scrollbar_right() {scrollbar.align(FL_ALIGN_RIGHT);}  void scrollbar_left() {scrollbar.align(FL_ALIGN_LEFT);}};#endif//// End of "$Id: Fl_Browser_.H 4288 2005-04-16 00:13:17Z mike $".//