<!-- ##### SECTION Title ##### -->GtkOptionMenu<!-- ##### SECTION Short_Description ##### -->A widget used to choose from a list of valid choices<!-- ##### SECTION Long_Description ##### --><para>A #GtkOptionMenu is a widget that allows the user to choose from alist of valid choices.  The #GtkOptionMenu displays the selected choice.  When activated the #GtkOptionMenu displays a popup #GtkMenu which allows the user to make a new choice.</para><para>Using a #GtkOptionMenu is simple; build a #GtkMenu, by callinggtk_menu_new(), then appending menu items to it with gtk_menu_shell_append(). Set that menu on the option menu with gtk_option_menu_set_menu(). Set the selected menu item withgtk_option_menu_set_history(); connect to the "changed" signal onthe option menu; in the "changed" signal, check the new selected menu item with gtk_option_menu_get_history().</para><para>As of GTK+ 2.4, #GtkOptionMenu has been deprecated in favor of #GtkComboBox.</para><!-- ##### SECTION See_Also ##### --><!-- ##### SECTION Stability_Level ##### --><!-- ##### STRUCT GtkOptionMenu ##### --><para>The #GtkOptionMenu-struct struct contains private data only, and should be accessed using the functions below.</para>@Deprecated: Use #GtkComboBox instead.<!-- ##### SIGNAL GtkOptionMenu::changed ##### --><para></para>@optionmenu: the object which received the signal.<!-- ##### ARG GtkOptionMenu:menu ##### --><para></para><!-- ##### ARG GtkOptionMenu:indicator-size ##### --><para></para><!-- ##### ARG GtkOptionMenu:indicator-spacing ##### --><para></para><!-- ##### FUNCTION gtk_option_menu_new ##### --><para>Creates a new #GtkOptionMenu.</para>@Returns: a new #GtkOptionMenu.@Deprecated: Use #GtkComboBox instead.<!-- ##### FUNCTION gtk_option_menu_get_menu ##### --><para>Returns the #GtkMenu associated with the #GtkOptionMenu.</para>@option_menu: a #GtkOptionMenu.@Returns: the #GtkMenu associated with the #GtkOptionMenu.@Deprecated: Use #GtkComboBox instead.<!-- ##### FUNCTION gtk_option_menu_set_menu ##### --><para>Provides the #GtkMenu that is popped up to allow the user to choosea new value.  You should provide a simple menu avoiding theuse of tearoff menu items, submenus, and accelerators.</para>@option_menu: a #GtkOptionMenu.@menu: the #GtkMenu to associate with the #GtkOptionMenu.@Deprecated: Use #GtkComboBox instead.<!-- ##### FUNCTION gtk_option_menu_remove_menu ##### --><para>Removes the menu from the option menu.</para>@option_menu: a #GtkOptionMenu.@Deprecated: Use #GtkComboBox instead.<!-- ##### FUNCTION gtk_option_menu_set_history ##### --><para>Selects the menu item specified by @index_ making it the newlyselected value for the option menu.</para>@option_menu: a #GtkOptionMenu.@index_: the index of the menu item to select.  Index values are from 0 to n-1.@Deprecated: Use #GtkComboBox instead.<!-- ##### FUNCTION gtk_option_menu_get_history ##### --><para></para>@option_menu: @Returns: