ODEmilButton - a multiple choice button widget
----------------------------------------------
Written by Johan Hanson <johan@tiq.com> for the file manager Gentoo by Emil Brink.
Johan wrote another widget originally that had a menu created by the widget.
Then Emil wanted to attach his own menus to the widget.. which required a
rewrite. Thus the "Emil" in "ODEmilButton".

The prefix OD is to signify that the widget is written by "Obsession Development"
and is not part of GTK. I also refuse to write my abbreviations in mixed caps!

License
-------
Copyright (C) 1999 Johan Hanson

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.


Usage by Users
--------------
- mouse button 1: handles as an ordinary button
- mouse button 2: selects second choice
- mouse button 3: pops up a menu

You can now also press down the left button to pop up the menu after a delay,
just like the "forward" and "back" buttons in Netscape 4.x. 


Usage by Programmers
--------------------
Hint: look in the header file.

See the supplied test program for all the features.
If you want a regular popup menu for the widget, you can use the regular
functions (od_emil_button_set_menu() ...) and then use
od_emil_button_set_none_active() to disable positioning and coloring
of the popup menu.

The paint functions are "virtual" so that they can be patched by theme engines.
Other than that, the widget is not written to be extended.
