
@c %start of fragment

@node GtkOptionMenu
@chapter GtkOptionMenu
A widget used to choose from a list of valid choices

@section Overview
A @code{<gtk-option-menu>} is a widget that allows the user to choose from a
list of valid choices. The @code{<gtk-option-menu>} displays the selected
choice. When activated the @code{<gtk-option-menu>} displays a popup
@code{<gtk-menu>} which allows the user to make a new choice.

Using a @code{<gtk-option-menu>} is simple; build a @code{<gtk-menu>}, by
calling @code{gtk-menu-new}, then appending menu items to it with
@code{gtk-menu-shell-append}. Set that menu on the option menu with
@code{gtk-option-menu-set-menu}. Set the selected menu item with
@code{gtk-option-menu-set-history}; connect to the "changed" signal on the
option menu; in the "changed" signal, check the new selected menu item with
@code{gtk-option-menu-get-history}.

As of GTK+ 2.4, @code{<gtk-option-menu>} has been deprecated in favor of
@code{<gtk-combo-box>}.

@section Usage
@include defuns-gtkoptionmenu.xml.texi

@c %end of fragment
