1 // 2 // "$Id$" 3 // 4 // Multiline input header file for the Fast Light Tool Kit (FLTK). 5 // 6 // Copyright 1998-2011 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_Multiline_Input widget . */ 21 22 #ifndef Fl_Multiline_Input_H 23 #define Fl_Multiline_Input_H 24 25 #include "Fl_Input.H" 26 27 /** 28 This input field displays '\\n' characters as new lines rather than ^J, 29 and accepts the Return, Tab, and up and down arrow keys. This is for 30 editing multiline text. 31 32 This is far from the nirvana of text editors, and is probably only 33 good for small bits of text, 10 lines at most. Note that this widget 34 does not support scrollbars or per-character color control. 35 36 If you are presenting large amounts of text and need scrollbars 37 or full color control of characters, you probably want Fl_Text_Editor 38 instead. 39 40 In FLTK 1.3.x, the default behavior of the 'Tab' key was changed 41 to support consistent focus navigation. To get the older FLTK 1.1.x 42 behavior, set Fl_Input_::tab_nav() to 0. Newer programs should consider using 43 Fl_Text_Editor. 44 */ 45 class FL_EXPORT Fl_Multiline_Input : public Fl_Input { 46 public: 47 /** 48 Creates a new Fl_Multiline_Input widget using the given 49 position, size, and label string. The default boxtype is FL_DOWN_BOX. 50 51 Inherited destructor destroys the widget and any value associated with it. 52 */ 53 Fl_Multiline_Input(int X,int Y,int W,int H,const char *l = 0); 54 }; 55 56 #endif 57 58 // 59 // End of "$Id$". 60 // 61