Fl_Input_Choice.H

//
// An input/chooser widget.
//            ______________  ____
//           |              || __ |
//           | input area   || \/ |
//           |______________||____|
//
// Copyright 2004 by Greg Ercolano.
// Copyright 1998-2024 by Bill Spitzak and others.
//
// This library is free software. Distribution and use rights are outlined in
// the file "COPYING" which should have been included with this file.  If this
// file is missing or damaged, see the license at:
//
//     https://www.fltk.org/COPYING.php
//
// Please see the following page on how to report bugs and issues:
//
//     https://www.fltk.org/bugs.php
//
 
/* \file
   Fl_Input_Choice widget . */
 
#ifndef Fl_Input_Choice_H
#define Fl_Input_Choice_H
 
#include <FL/Fl.H>
#include <FL/Fl_Group.H>
#include <FL/Fl_Input.H>
#include <FL/Fl_Menu_Button.H>
 
/*
  A combination of the input widget and a menu button.
 
  The user can either type into the input area, or use the
  menu button chooser on the right to choose an item which loads
  the input area with the selected text.
 
  Note: doxygen docs in src/Fl_Input_Choice.cxx
*/
 
class FL_EXPORT Fl_Input_Choice : public Fl_Group {
 
  // Private class to handle slightly 'special' behavior of menu button
  class InputMenuButton : public Fl_Menu_Button {
    void draw() FL_OVERRIDE;
    const Fl_Menu_Item* popup();
  public:
    InputMenuButton(int X, int Y, int W, int H, const char *L=0);
    int handle(int e) FL_OVERRIDE;
  };
 
  Fl_Input *inp_;
  InputMenuButton *menu_;
 
  // note: this is used by the Fl_Input_Choice ctor.
  static void menu_cb(Fl_Widget*, void *data);
 
  // note: this is used by the Fl_Input_Choice ctor.
  static void inp_cb(Fl_Widget*, void *data);
 
protected:
  // Custom resize behavior -- input stretches, menu button doesn't

  virtual int inp_x() const { return(x() + Fl::box_dx(box())); }
  virtual int inp_y() const { return(y() + Fl::box_dy(box())); }
  virtual int inp_w() const { return(w() - Fl::box_dw(box()) - menu_w()); }
  virtual int inp_h() const { return(h() - Fl::box_dh(box())); }

  virtual int menu_x() const { return x() + w() - menu_w() - Fl::box_dx(box()); }
  virtual int menu_y() const { return y() + Fl::box_dy(box()); }
  virtual int menu_w() const { return 20; }
  virtual int menu_h() const { return h() - Fl::box_dh(box()); }
 
  void draw() FL_OVERRIDE;
 
public:
 
  Fl_Input_Choice(int X, int Y, int W, int H, const char *L=0);
 
  void resize(int X, int Y, int W, int H) FL_OVERRIDE;

  void add(const char *s) { menu_->add(s); }

  int changed() const { return inp_->changed() | Fl_Widget::changed(); }
 
  // Clears the changed() state of both input and menu button widgets.
  void clear_changed();
 
  // Sets the changed() state of both input and menu button widgets.
  void set_changed();

  void clear() { menu_->clear(); }

  Fl_Boxtype down_box() const { return (menu_->down_box()); }

  void down_box(Fl_Boxtype b) { menu_->down_box(b); }

  const Fl_Menu_Item *menu() { return (menu_->menu()); }

  void menu(const Fl_Menu_Item *m) { menu_->menu(m); }

  Fl_Color textcolor() const { return (inp_->textcolor());}

  void textcolor(Fl_Color c) { inp_->textcolor(c);}

  Fl_Font textfont() const { return (inp_->textfont());}

  void textfont(Fl_Font f) { inp_->textfont(f);}

  Fl_Fontsize textsize() const { return (inp_->textsize()); }

  void textsize(Fl_Fontsize s) { inp_->textsize(s); }

  const char* value() const { return (inp_->value()); }

  void value(const char *val) { inp_->value(val); }
 
  /* Chooses item# \p val in the menu, and sets the Fl_Input text field
    to that value. Any previous text is cleared. */
  void value(int val);
 
  int update_menubutton();

  Fl_Menu_Button *menubutton() { return menu_; }

  Fl_Input *input() { return inp_; }
};
 
#endif // !Fl_Input_Choice_H