FLTK 1.3.2
Fl_Browser_.H
1 //
2 // "$Id: Fl_Browser_.H 9126 2011-10-04 13:10:55Z manolo $"
3 //
4 // Common browser header file for the Fast Light Tool Kit (FLTK).
5 //
6 // Copyright 1998-2010 by Bill Spitzak and others.
7 //
8 // This library is free software. Distribution and use rights are outlined in
9 // the file "COPYING" which should have been included with this file. If this
10 // file is missing or damaged, see the license at:
11 //
12 // http://www.fltk.org/COPYING.php
13 //
14 // Please report all bugs and problems on the following page:
15 //
16 // http://www.fltk.org/str.php
17 //
18 
19 /* \file
20  Fl_Browser_ widget . */
21 
22 // Yes, I know this should be a template...
23 
24 #ifndef Fl_Browser__H
25 #define Fl_Browser__H
26 
27 #ifndef Fl_Group_H
28 #include "Fl_Group.H"
29 #endif
30 #include "Fl_Scrollbar.H"
31 #include <FL/Fl.H> // Fl::scrollbar_size()
32 
33 #define FL_NORMAL_BROWSER 0
34 #define FL_SELECT_BROWSER 1
35 #define FL_HOLD_BROWSER 2
36 #define FL_MULTI_BROWSER 3
38 #define FL_SORT_ASCENDING 0
39 #define FL_SORT_DESCENDING 1
58 class FL_EXPORT Fl_Browser_ : public Fl_Group {
59  int position_; // where user wants it scrolled to
60  int real_position_; // the current vertical scrolling position
61  int hposition_; // where user wants it panned to
62  int real_hposition_; // the current horizontal scrolling position
63  int offset_; // how far down top_ item the real_position is
64  int max_width; // widest object seen so far
65  uchar has_scrollbar_; // which scrollbars are enabled
66  Fl_Font textfont_;
67  Fl_Fontsize textsize_;
68  Fl_Color textcolor_;
69  void* top_; // which item scrolling position is in
70  void* selection_; // which is selected (except for FL_MULTI_BROWSER)
71  void *redraw1,*redraw2; // minimal update pointers
72  void* max_width_item; // which item has max_width_
73  int scrollbar_size_; // size of scrollbar trough
74 
75  void update_top();
76 
77 protected:
78 
79  // All of the following must be supplied by the subclass:
85  virtual void *item_first() const = 0;
91  virtual void *item_next(void *item) const = 0;
97  virtual void *item_prev(void *item) const = 0;
103  virtual void *item_last() const { return 0L; }
112  virtual int item_height(void *item) const = 0;
120  virtual int item_width(void *item) const = 0;
121  virtual int item_quick_height(void *item) const ;
126  virtual void item_draw(void *item,int X,int Y,int W,int H) const = 0;
132  virtual const char *item_text(void *item) const { (void)item; return 0L; }
138  virtual void item_swap(void *a,void *b) { (void)a; (void)b; }
145  virtual void *item_at(int index) const { (void)index; return 0L; }
146  // you don't have to provide these but it may help speed it up:
147  virtual int full_width() const ; // current width of all items
148  virtual int full_height() const ; // current height of all items
149  virtual int incr_height() const ; // average height of an item
150  // These only need to be done by subclass if you want a multi-browser:
151  virtual void item_select(void *item,int val=1);
152  virtual int item_selected(void *item) const ;
153 
154  // things the subclass may want to call:
158  void *top() const { return top_; }
166  void *selection() const { return selection_; }
167  void new_list(); // completely clobber all data, as though list replaced
168  void deleting(void *item); // get rid of any pointers to item
169  void replacing(void *a,void *b); // change a pointers to b
170  void swapping(void *a,void *b); // exchange pointers a and b
171  void inserting(void *a,void *b); // insert b near a
172  int displayed(void *item) const ; // true if this item is visible
173  void redraw_line(void *item); // minimal update, no change in size
178  void redraw_lines() { damage(FL_DAMAGE_SCROLL); } // redraw all of them
179  void bbox(int &X,int &Y,int &W,int &H) const;
180  int leftedge() const; // x position after scrollbar & border
181  void *find_item(int ypos); // item under mouse
182 
183  void draw();
184  Fl_Browser_(int X,int Y,int W,int H,const char *L=0);
185 
186 public:
187 
196 
197  int handle(int event);
198  void resize(int X,int Y,int W,int H);
199 
200  int select(void *item,int val=1,int docallbacks=0);
201  int select_only(void *item,int docallbacks=0);
202  int deselect(int docallbacks=0);
210  int position() const { return position_; }
211  void position(int pos); // scroll to here
219  int hposition() const { return hposition_; }
220  void hposition(int); // pan to here
221  void display(void *item); // scroll so this item is shown
222 
232  enum { // values for has_scrollbar()
233  HORIZONTAL = 1,
234  VERTICAL = 2,
235  BOTH = 3,
236  ALWAYS_ON = 4,
237  HORIZONTAL_ALWAYS = 5,
238  VERTICAL_ALWAYS = 6,
239  BOTH_ALWAYS = 7
240  };
244  uchar has_scrollbar() const { return has_scrollbar_; }
267  void has_scrollbar(uchar mode) { has_scrollbar_ = mode; }
268 
273  Fl_Font textfont() const { return textfont_; }
277  void textfont(Fl_Font font) { textfont_ = font; }
278 
282  Fl_Fontsize textsize() const { return textsize_; }
286  void textsize(Fl_Fontsize newSize) { textsize_ = newSize; }
287 
291  Fl_Color textcolor() const { return textcolor_; }
295  void textcolor(Fl_Color col) { textcolor_ = col; }
296 
306  int scrollbar_size() const {
307  return(scrollbar_size_);
308  }
328  void scrollbar_size(int newSize) {
329  scrollbar_size_ = newSize;
330  }
338  int scrollbar_width() const {
339  return(Fl::scrollbar_size());
340  }
348  void scrollbar_width(int width) {
349  Fl::scrollbar_size(width);
350  scrollbar_size_ = 0;
351  }
356  void scrollbar_right() { scrollbar.align(FL_ALIGN_RIGHT); }
361  void scrollbar_left() { scrollbar.align(FL_ALIGN_LEFT); }
362  void sort(int flags=0);
363 };
364 
365 #endif
366 
367 //
368 // End of "$Id: Fl_Browser_.H 9126 2011-10-04 13:10:55Z manolo $".
369 //
Fl_Fontsize textsize() const
Gets the default text size (in pixels) for the lines in the browser.
Definition: Fl_Browser_.H:282
void scrollbar_left()
Moves the vertical scrollbar to the lefthand side of the list.
Definition: Fl_Browser_.H:361
Fl_Align align() const
Gets the label alignment.
Definition: Fl_Widget.H:336
int scrollbar_size() const
Gets the current size of the scrollbars' troughs, in pixels.
Definition: Fl_Browser_.H:306
void * selection() const
Returns the item currently selected, or NULL if there is no selection.
Definition: Fl_Browser_.H:166
Fl static class.
void textcolor(Fl_Color col)
Sets the default text color for the lines in the browser to color col.
Definition: Fl_Browser_.H:295
Fl_Color textcolor() const
Gets the default text color for the lines in the browser.
Definition: Fl_Browser_.H:291
This is the base class for browsers.
Definition: Fl_Browser_.H:58
void scrollbar_right()
Moves the vertical scrollbar to the righthand side of the list.
Definition: Fl_Browser_.H:356
Fl_Scrollbar hscrollbar
Horizontal scrollbar.
Definition: Fl_Browser_.H:195
void * top() const
Returns the item that appears at the top of the list.
Definition: Fl_Browser_.H:158
virtual const char * item_text(void *item) const
This optional method returns a string (label) that may be used for sorting.
Definition: Fl_Browser_.H:132
void textfont(Fl_Font font)
Sets the default text font for the lines in the browser to font.
Definition: Fl_Browser_.H:277
Fl_Scrollbar scrollbar
Vertical scrollbar.
Definition: Fl_Browser_.H:191
virtual void item_swap(void *a, void *b)
This optional method should be provided by the subclass to efficiently swap browser items a and b...
Definition: Fl_Browser_.H:138
The Fl_Scroll widget was scrolled.
Definition: Enumerations.H:947
Fl_Font textfont() const
Gets the default text font for the lines in the browser.
Definition: Fl_Browser_.H:273
void textsize(Fl_Fontsize newSize)
Sets the default text size (in pixels) for the lines in the browser to size.
Definition: Fl_Browser_.H:286
int Fl_Fontsize
Size of a font in pixels.
Definition: Enumerations.H:746
virtual void * item_last() const
This method must be provided by the subclass to return the last item in the list. ...
Definition: Fl_Browser_.H:103
void has_scrollbar(uchar mode)
Sets whether the widget should have scrollbars or not (default Fl_Browser_::BOTH).
Definition: Fl_Browser_.H:267
virtual void * item_at(int index) const
This method must be provided by the subclass to return the item for the specified index...
Definition: Fl_Browser_.H:145
void scrollbar_size(int newSize)
Sets the pixel size of the scrollbars' troughs to newSize, in pixels.
Definition: Fl_Browser_.H:328
unsigned int Fl_Color
an FLTK color value
Definition: Enumerations.H:774
static int scrollbar_size()
Gets the default scrollbar size used by Fl_Browser_, Fl_Help_View, Fl_Scroll, and Fl_Text_Display wid...
Definition: Fl.cxx:142
int Fl_Font
A font number is an index into the internal font table.
Definition: Enumerations.H:717
int position() const
Gets the vertical scroll position of the list as a pixel position pos.
Definition: Fl_Browser_.H:210
uchar has_scrollbar() const
Returns the current scrollbar mode, see Fl_Browser_::has_scrollbar(uchar)
Definition: Fl_Browser_.H:244
void redraw_lines()
This method will cause the entire list to be redrawn.
Definition: Fl_Browser_.H:178
const Fl_Align FL_ALIGN_LEFT
Align the label at the left of the widget.
Definition: Enumerations.H:679
int scrollbar_width() const
This method has been deprecated, existing for backwards compatibility only.
Definition: Fl_Browser_.H:338
void scrollbar_width(int width)
This method has been deprecated, existing for backwards compatibility only.
Definition: Fl_Browser_.H:348
The Fl_Scrollbar widget displays a slider with arrow buttons at the ends of the scrollbar.
Definition: Fl_Scrollbar.H:43
unsigned char uchar
unsigned char
Definition: fl_types.h:30
const Fl_Align FL_ALIGN_RIGHT
Align the label to the right of the widget.
Definition: Enumerations.H:681
int hposition() const
Gets the horizontal scroll position of the list as a pixel position pos.
Definition: Fl_Browser_.H:219