From 4db42c29968b4610d4ebf89f734f31dac8b9973d Mon Sep 17 00:00:00 2001 From: engelsman Date: Wed, 1 Oct 2008 18:43:10 +0000 Subject: doxygen comments for undocumented features of Fl_File_Init - is Fl_File_Input::errorcolor() ever used? git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6362 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 --- FL/Fl_File_Input.H | 32 ++++++++++++++++++++++++++------ 1 file changed, 26 insertions(+), 6 deletions(-) (limited to 'FL/Fl_File_Input.H') diff --git a/FL/Fl_File_Input.H b/FL/Fl_File_Input.H index 6febdb5f8..8e32a9e67 100644 --- a/FL/Fl_File_Input.H +++ b/FL/Fl_File_Input.H @@ -34,7 +34,15 @@ # include +/** + \class Fl_File_Input + \brief This widget displays a pathname in a text input field. + A navigation bar located above the input field allows the user to + navigate upward in the directory tree. + + \image html Fl_File_Input.gif +*/ class FL_EXPORT Fl_File_Input : public Fl_Input { Fl_Color errorcolor_; @@ -49,19 +57,31 @@ class FL_EXPORT Fl_File_Input : public Fl_Input public: - Fl_File_Input(int,int,int,int,const char *t=0); + Fl_File_Input(int X, int Y, int W, int H, const char *L=0); - virtual int handle(int); + virtual int handle(int event); virtual void draw(); - /** Gets or sets the box type to use for the navigation bar. */ + /** Gets the box type used for the navigation bar. */ Fl_Boxtype down_box() const { return (Fl_Boxtype)down_box_; } - /** Gets or sets the box type to use for the navigation bar. */ + /** Sets the box type to use for the navigation bar. */ void down_box(Fl_Boxtype b) { down_box_ = b; } + + /** + Gets the current error color. + \todo Better docs for Fl_File_Input::errorcolor() - is it even used? + */ Fl_Color errorcolor() const { return errorcolor_; } + /** Sets the current error color to \a c */ void errorcolor(Fl_Color c) { errorcolor_ = c; } - int value(const char*); - int value(const char*, int); + + int value(const char *str); + int value(const char *str, int len); + + /** + Returns the current value, which is a pointer to an internal buffer + and is valid only until the next event is handled. + */ const char *value() { return Fl_Input_::value(); } }; -- cgit v1.2.3