mirror of https://github.com/fltk/fltk
147 lines
5.2 KiB
C++
147 lines
5.2 KiB
C++
//
|
|
// "$Id$"
|
|
//
|
|
// Menu base class header file for the Fast Light Tool Kit (FLTK).
|
|
//
|
|
// Copyright 1998-2009 by Bill Spitzak and others.
|
|
//
|
|
// This library is free software; you can redistribute it and/or
|
|
// modify it under the terms of the GNU Library General Public
|
|
// License as published by the Free Software Foundation; either
|
|
// version 2 of the License, or (at your option) any later version.
|
|
//
|
|
// This library is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
// Library General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Library General Public
|
|
// License along with this library; if not, write to the Free Software
|
|
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
|
|
// USA.
|
|
//
|
|
// Please report all bugs and problems on the following page:
|
|
//
|
|
// http://www.fltk.org/str.php
|
|
//
|
|
|
|
/* \file
|
|
Fl_Menu_ widget . */
|
|
|
|
#ifndef Fl_Menu__H
|
|
#define Fl_Menu__H
|
|
|
|
#ifndef Fl_Widget_H
|
|
#include "Fl_Widget.H"
|
|
#endif
|
|
#include "Fl_Menu_Item.H"
|
|
|
|
/**
|
|
Base class of all widgets that have a menu in FLTK.
|
|
Currently FLTK provides you with
|
|
Fl_Menu_Button, Fl_Menu_Bar, and Fl_Choice.
|
|
|
|
<P>The class contains a pointer to an array of structures of type Fl_Menu_Item. The
|
|
array may either be supplied directly by the user program, or it may
|
|
be "private": a dynamically allocated array managed by the Fl_Menu_.
|
|
*/
|
|
class FL_EXPORT Fl_Menu_ : public Fl_Widget {
|
|
|
|
Fl_Menu_Item *menu_;
|
|
const Fl_Menu_Item *value_;
|
|
|
|
protected:
|
|
|
|
uchar alloc;
|
|
uchar down_box_;
|
|
Fl_Font textfont_;
|
|
Fl_Fontsize textsize_;
|
|
unsigned textcolor_;
|
|
|
|
public:
|
|
Fl_Menu_(int,int,int,int,const char * =0);
|
|
~Fl_Menu_();
|
|
|
|
int item_pathname(char *name, int namelen, const Fl_Menu_Item *finditem=0) const;
|
|
const Fl_Menu_Item* picked(const Fl_Menu_Item*);
|
|
const Fl_Menu_Item* find_item(const char *name);
|
|
|
|
const Fl_Menu_Item* test_shortcut() {return picked(menu()->test_shortcut());}
|
|
void global();
|
|
|
|
/**
|
|
Returns a pointer to the array of Fl_Menu_Items. This will either be
|
|
the value passed to menu(value) or the private copy.
|
|
*/
|
|
const Fl_Menu_Item *menu() const {return menu_;}
|
|
void menu(const Fl_Menu_Item *m);
|
|
void copy(const Fl_Menu_Item *m, void* user_data = 0);
|
|
int add(const char*, int shortcut, Fl_Callback*, void* = 0, int = 0);
|
|
/** See int Fl_Menu_::add(const char* label, int shortcut, Fl_Callback*, void *user_data=0, int flags=0)*/
|
|
int add(const char* a, const char* b, Fl_Callback* c, void* d = 0, int e = 0) {
|
|
return add(a,fl_old_shortcut(b),c,d,e);}
|
|
int add(const char *);
|
|
int size() const ;
|
|
void size(int W, int H) { Fl_Widget::size(W, H); }
|
|
void clear();
|
|
void replace(int,const char *);
|
|
void remove(int);
|
|
/** Changes the shortcut of item i to n. */
|
|
void shortcut(int i, int s) {menu_[i].shortcut(s);}
|
|
/** Sets the flags of item i. For a list of the flags, see Fl_Menu_Item. */
|
|
void mode(int i,int fl) {menu_[i].flags = fl;}
|
|
/** Gets the flags of item i. For a list of the flags, see Fl_Menu_Item. */
|
|
int mode(int i) const {return menu_[i].flags;}
|
|
|
|
/** Returns a pointer to the last menu item that was picked. */
|
|
const Fl_Menu_Item *mvalue() const {return value_;}
|
|
/** Returns the index into menu() of the last item chosen by the user. It is zero initially. */
|
|
int value() const {return value_ ? (int)(value_-menu_) : -1;}
|
|
int value(const Fl_Menu_Item*);
|
|
/**
|
|
The value is the index into menu() of the last item chosen by
|
|
the user. It is zero initially. You can set it as an integer, or set
|
|
it with a pointer to a menu item. The set routines return non-zero if
|
|
the new value is different than the old one.
|
|
*/
|
|
int value(int i) {return value(menu_+i);}
|
|
/** Returns the title of the last item chosen, or of item i. */
|
|
const char *text() const {return value_ ? value_->text : 0;}
|
|
/** Returns the title of the last item chosen, or of item i. */
|
|
const char *text(int i) const {return menu_[i].text;}
|
|
|
|
/** Gets the current font of menu item labels. */
|
|
Fl_Font textfont() const {return textfont_;}
|
|
/** Sets the current font of menu item labels. */
|
|
void textfont(Fl_Font c) {textfont_=c;}
|
|
/** Gets the font size of menu item labels. */
|
|
Fl_Fontsize textsize() const {return textsize_;}
|
|
/** Sets the font size of menu item labels. */
|
|
void textsize(Fl_Fontsize c) {textsize_=c;}
|
|
/** Get the current color of menu item labels. */
|
|
Fl_Color textcolor() const {return (Fl_Color)textcolor_;}
|
|
/** Sets the current color of menu item labels. */
|
|
void textcolor(unsigned c) {textcolor_=c;}
|
|
|
|
/**
|
|
This box type is used to surround the currently-selected items in the
|
|
menus. If this is FL_NO_BOX then it acts like
|
|
FL_THIN_UP_BOX and selection_color() acts like
|
|
FL_WHITE, for back compatibility.
|
|
*/
|
|
Fl_Boxtype down_box() const {return (Fl_Boxtype)down_box_;}
|
|
/** See Fl_Boxtype Fl_Menu_::down_box() const */
|
|
void down_box(Fl_Boxtype b) {down_box_ = b;}
|
|
|
|
/** For back compatibility, same as selection_color() */
|
|
Fl_Color down_color() const {return selection_color();}
|
|
/** For back compatibility, same as selection_color() */
|
|
void down_color(unsigned c) {selection_color(c);}
|
|
};
|
|
|
|
#endif
|
|
|
|
//
|
|
// End of "$Id$".
|
|
//
|