add808d7c2
including one that was set with menu(). It copies the static menu if necessary and keeps track of the size of the menu so it can reallocate the array exactly when necessary. This should make modifying the items in a menu much more predictable and usefule. I don't know if these changes will go cleanly into 2.0. Probably not. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.0@550 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
205 lines
8.3 KiB
HTML
205 lines
8.3 KiB
HTML
<HTML><BODY>
|
|
<HR break>
|
|
<H2><A name=Fl_Menu_>class Fl_Menu_</A></H2>
|
|
<HR>
|
|
<H3>Class Hierarchy</H3>
|
|
<UL>
|
|
<PRE>
|
|
<A href=Fl_Widget.html#Fl_Widget>Fl_Widget</A>
|
|
|
|
|
+----<B>Fl_Menu_</B>----<A href=Fl_Menu_Item.html#Fl_Menu_Item>Fl_Menu_Item</A>
|
|
|
|
|
+----<A href=Fl_Choice.html#Fl_Choice>Fl_Choice</A>, <A href=Fl_Menu_Bar.html#Fl_Menu_Bar>Fl_Menu_Bar</A>, <A href=Fl_Menu_Button.html#Fl_Menu_Button>Fl_Menu_Button</A>
|
|
</PRE>
|
|
</UL>
|
|
<H3>Include Files</H3>
|
|
<UL>
|
|
<PRE>
|
|
#include <FL/Fl_Menu_.H>
|
|
</PRE>
|
|
</UL>
|
|
<H3>Description</H3>
|
|
All widgets that have a menu in FLTK are subclassed off of this class.
|
|
Currently FLTK provides you with <A href=Fl_Menu_Button.html#Fl_Menu_Button>
|
|
<TT>Fl_Menu_Button</TT></A>, <A href=Fl_Menu_Bar.html#Fl_Menu_Bar><TT>
|
|
Fl_Menu_Bar</TT></A>, and <A href=functions.html#Fl_Choice><TT>Fl_Choice</TT>
|
|
</A>.
|
|
|
|
<P>The class contains a pointer to an array of structures of type <A
|
|
href=Fl_Menu_Item.html#Fl_Menu_Item> <TT>Fl_Menu_Item</TT></A>. 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_.
|
|
|
|
<H3>Methods</H3>
|
|
<CENTER>
|
|
<TABLE width=90%>
|
|
<TR><TD align=left valign=top>
|
|
<UL>
|
|
<LI><A href=#Fl_Menu_.Fl_Menu_>Fl_Menu_</A></LI>
|
|
<LI><A href=#Fl_Menu_.~Fl_Menu_>~Fl_Menu_</A></LI>
|
|
<LI><A href=#Fl_Menu_.add>add</A></LI>
|
|
<LI><A href=#Fl_Menu_.clear>clear</A></LI>
|
|
</UL>
|
|
</TD><TD align=left valign=top>
|
|
<UL>
|
|
<LI><A href=#Fl_Menu_.copy>copy</A></LI>
|
|
<LI><A href=#Fl_Menu_.down_box>down_box</A></LI>
|
|
<LI><A href=#Fl_Menu_.global>global</A></LI>
|
|
<LI><A href=#Fl_Menu_.menu>menu</A></LI>
|
|
</UL>
|
|
</TD><TD align=left valign=top>
|
|
<UL>
|
|
<LI><A href=#Fl_Menu_.mode>mode</A></LI>
|
|
<LI><A href=#Fl_Menu_.remove>remove</A></LI>
|
|
<LI><A href=#Fl_Menu_.replace>replace</A></LI>
|
|
<LI><A href=#Fl_Menu_.shortcut>shortcut</A></LI>
|
|
</UL>
|
|
</TD><TD align=left valign=top>
|
|
<UL>
|
|
<LI><A href=#Fl_Menu_.size>size</A></LI>
|
|
<LI><A href=#Fl_Menu_.test_shortcut>test_shortcut</A></LI>
|
|
<LI><A href=#Fl_Menu_.text>text</A></LI>
|
|
<LI><A href=#Fl_Menu_.textcolor>textcolor</A></LI>
|
|
</UL>
|
|
</TD><TD align=left valign=top>
|
|
<UL>
|
|
<LI><A href=#Fl_Menu_.textfont>textfont</A></LI>
|
|
<LI><A href=#Fl_Menu_.textsize>textsize</A></LI>
|
|
<LI><A href=#Fl_Menu_.value>value</A></LI>
|
|
</UL>
|
|
</TD></TR>
|
|
</TABLE>
|
|
</CENTER>
|
|
|
|
<H4><A name=Fl_Menu_.Fl_Menu_>Fl_Menu_::Fl_Menu_(int x, int y, int w,
|
|
int h, const char *label = 0)</A></H4>
|
|
|
|
Creates a new <TT>Fl_Menu_</TT> widget using the given position, size,
|
|
and label string.<tt> menu()</tt> is initialized to null.
|
|
|
|
<H4><A name=Fl_Menu_.~Fl_Menu_>virtual Fl_Menu_::~Fl_Menu_()</A></H4>
|
|
|
|
If the menu array is private the memory it uses is freed.
|
|
|
|
<H4><A name=Fl_Menu_.menu>const Fl_Menu_Item* Fl_Menu_::menu()
|
|
const</a></h4>
|
|
|
|
Returns a pointer to the array of Fl_Menu_Items. This will either be
|
|
the value passed to <tt>menu(value)</tt> or the private copy.
|
|
|
|
<h4>void Fl_Menu_::menu(const Fl_Menu_Item*)</H4>
|
|
Set the menu array pointer directly. If the old menu is private it is
|
|
deleted. <tt>NULL</tt> is allowed and acts the same as a zero-length
|
|
menu. If you try to modify the array (with add(), replace(), or
|
|
delete()) a private copy is automatically done.
|
|
|
|
<H4><A name=Fl_Menu_.copy>void Fl_Menu_::copy(const
|
|
Fl_Menu_Item*)</A></H4>
|
|
The menu is set to a private copy of the passed Fl_Menu_Item array.
|
|
This is useful if you want to modify the flags of the menu items.
|
|
|
|
<H4><A name=Fl_Menu_.clear>void Fl_Menu_::clear()</A></H4>
|
|
Same as <tt>menu(NULL)</tt>, set the array pointer to null, indicating
|
|
a zero-length menu.
|
|
|
|
<H4><A name=Fl_Menu_.size>int Fl_Menu_::size() const</A></H4>
|
|
|
|
This returns the number of Fl_Menu_Item structures that make up the
|
|
menu, correctly counting submenus. This includes the "terminator"
|
|
item at the end. To copy a menu array you need to copy
|
|
<tt>size()*sizeof(Fl_Menu_Item)</tt> bytes. If the menu is
|
|
<TT>NULL</TT> this returns zero (an empty menu will return 1).
|
|
|
|
<H4><A name=Fl_Menu_.add>int Fl_Menu_::add(const char* label, const
|
|
char* shortcut, Fl_Callback*, void *user_data=0, int flags=0)</a></h4>
|
|
|
|
Adds a new menu item, with a <TT>title</TT> string, <TT> shortcut</TT>
|
|
string, <TT>callback</TT>, argument to the callback, and flags. If
|
|
the menu array was directly set with menu(x) then copy() is done to
|
|
make a private array.
|
|
|
|
<P>Text is a string of the form "foo/bar/baz", this example
|
|
will result in a submenu called "foo" and one in that called
|
|
"bar" and and entry called "baz". The text is
|
|
copied to new memory and can be freed. The other arguments (including
|
|
the shortcut) are copied into the menu item unchanged. </P>
|
|
|
|
<P>If an item exists already with that name then it is replaced with
|
|
this new one. Otherwise this new one is added to the end of the
|
|
correct menu or submenu. The return value is the offset into the array
|
|
that the new entry was placed at.</P>
|
|
|
|
<P>The return value is the index into the array that the entry was put. </P>
|
|
|
|
<h4>int Fl_Menu_::add(const char *)</A></H4>
|
|
|
|
<P>The passed string is split at any '|' characters and then <TT>
|
|
add(s,0,0,0,0)</TT> is done with each section. This is often useful
|
|
if you are just using the value, and is compatable with Forms
|
|
and other GL programs. </P>
|
|
|
|
<H4><A name=Fl_Menu_.replace>void Fl_Menu_::replace(int n, const char *)</A>
|
|
</H4>
|
|
|
|
Changes the text of item <TT>n</TT>. This is the only way to get
|
|
slash into an add()'ed menu item. If the menu array was directly set
|
|
with menu(x) then copy() is done to make a private array.
|
|
|
|
<H4><A name=Fl_Menu_.remove>void Fl_Menu_::remove(int n)</A></H4>
|
|
|
|
Deletes item <TT>n</TT> from the menu. If the menu array was directly
|
|
set with menu(x) then copy() is done to make a private array.
|
|
|
|
<H4><A name=Fl_Menu_.shortcut>void Fl_Menu_::shortcut(int i, int n);</A></H4>
|
|
|
|
Changes the shortcut of item <TT>i</TT> to <TT>n</TT>.
|
|
|
|
<H4><A name=Fl_Menu_.mode>void Fl_Menu_::mode(int i, int x);</A></H4>
|
|
|
|
Changes the flags of item <TT>i</TT>. For a list of the flags, see <a
|
|
href=Fl_Menu_Item.html>Fl_Menu_Item</a>.
|
|
|
|
<H4><A name=Fl_Menu_.value>int Fl_Menu_::value() const
|
|
<BR> int Fl_Menu_::value(int)
|
|
<BR> const Fl_Menu_Item* mvalue() const
|
|
<BR> int Fl_Menu_::value(const Fl_Menu_Item*)</A></H4>
|
|
The value is the index into <TT>menu()</TT> 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.
|
|
|
|
<H4><A name=Fl_Menu_.test_shortcut>const Fl_Menu_Item*
|
|
Fl_Menu_::test_shortcut()</A></H4>
|
|
Only call this in response to <TT>FL_SHORTCUT events</TT>. If the
|
|
event matches an entry in the menu that entry is selected and the
|
|
callback will be done (or <TT>changed()</TT> will be set). This allows
|
|
shortcuts directed at one window to call menus in another.
|
|
<H4><A name=Fl_Menu_.global>void Fl_Menu_::global()</A></H4>
|
|
Make the shortcuts for this menu work no matter what window has the
|
|
focus when you type it. This is done by using <A href=osissues.html#add_handler>
|
|
<TT>Fl::add_handler()</TT></A>. This <TT>Fl_Menu_</TT> widget does not
|
|
have to be visible (ie the window it is in can be hidden, or it does
|
|
not have to be put in a window at all).
|
|
<P>Currently there can be only one <TT>global()</TT>menu. Setting a new
|
|
one will replace the old one. There is no way to remove the <TT>
|
|
global()</TT> setting (so don't destroy the widget!)</P>
|
|
<H4><A name=Fl_Menu_.text>const char* Fl_Menu_::text() const
|
|
<BR> const char* Fl_Menu_::text(int i) const</A></H4>
|
|
Returns the title of the last item chosen, or of item <TT>i</TT>.
|
|
|
|
<H4><A name=Fl_Menu_.textcolor>Fl_Color Fl_Menu_::textcolor() const
|
|
<BR> void Fl_Menu_::textcolor(Fl_Color)</A></H4>
|
|
Get or set the current color of menu item labels.
|
|
<H4><A name=Fl_Menu_.textfont>Fl_Font Fl_Menu_::textfont() const
|
|
<BR> void Fl_Menu_::textfont(Fl_Font)</A></H4>
|
|
Get or set the current font of menu item labels.
|
|
<H4><A name=Fl_Menu_.textsize>uchar Fl_Menu_::textsize() const
|
|
<BR> void Fl_Menu_::textsize(uchar)</A></H4>
|
|
Get or set the font size of menu item labels.
|
|
<H4><A name=Fl_Menu_.down_box>Fl_Boxtype Fl_Menu_::down_box() const
|
|
<BR> void Fl_Menu_::down_box(Fl_Boxtype)</A></H4>
|
|
This box type is used to surround the currently-selected items in the
|
|
menus. If this is <TT>FL_NO_BOX</TT> then it acts like <TT>
|
|
FL_THIN_UP_BOX</TT> and <TT>selection_color()</TT> acts like <TT>
|
|
FL_WHITE</TT>, for back compatability. </BODY></HTML>
|