A button that is used to pop up a menu. More...
|Fl_Choice (int X, int Y, int W, int H, const char *L=0)|
|Create a new Fl_Choice widget using the given position, size and label string. |
|Handles the specified event. |
|int||value () const|
|Gets the index of the last item chosen by the user. |
|int||value (int v)|
|Sets the currently selected value using the index into the menu item array. |
|int||value (const Fl_Menu_Item *v)|
|Sets the currently selected value using a pointer to menu item. |
|Draws the widget. |
A button that is used to pop up a menu.
This is a button that, when pushed, pops up a menu (or hierarchy of menus) defined by an array of Fl_Menu_Item objects. Motif calls this an OptionButton.
The only difference between this and a Fl_Menu_Button is that the name of the most recent chosen menu item is displayed inside the box, while the label is displayed outside the box. However, since the use of this is most often to control a single variable rather than do individual callbacks, some of the Fl_Menu_Button methods are redescribed here in those terms.
When the user picks an item off the menu the value() is set to that item and then the item's callback is done with the menu_button as the
Fl_Widget* argument. If the item does not have a callback the menu_button's callback is done instead.
All three mouse buttons pop up the menu. The Forms behavior of the first two buttons to increment/decrement the choice is not implemented. This could be added with a subclass, however.
Typing the shortcut() of any of the items will do exactly the same as when you pick the item with the mouse. The '&' character in item names are only looked at when the menu is popped up, however.
int Fl_Widget::changed() constThis value is true the user picks a different value. It is turned off by value() and just before doing a callback (the callback can turn it back on if desired).
void Fl_Widget::set_changed()This method sets the changed() flag.
void Fl_Widget::clear_changed()This method clears the changed() flag.
Fl_Boxtype Fl_Choice::down_box() constGets the current down box, which is used when the menu is popped up. The default down box type is
void Fl_Choice::down_box(Fl_Boxtype b)Sets the current down box type to
|const char *||L =
Draws the widget.
Never call this function directly. FLTK will schedule redrawing whenever needed. If your widget must be redrawn as soon as possible, call redraw() instead.
Override this function to draw your own widgets.
Handles the specified event.
You normally don't call this method directly, but instead let FLTK do it when the user interacts with the widget.
When implemented in a widget, this function must return 0 if the widget does not use the event or 1 otherwise.
Most of the time, you want to call the inherited handle() method in your overridden method so that you don't short-circuit events that you don't handle. In this last case you should return the callee retval.
|[in]||event||the kind of event received|
|0||if the event was not used or understood|
|1||if the event was used and can be deleted|
Reimplemented from Fl_Widget.
|int Fl_Choice::value||(||)|| const
Gets the index of the last item chosen by the user.
The index is zero initially.
Reimplemented from Fl_Menu_.
|int Fl_Choice::value||(||const Fl_Menu_Item *||v||)|