GtkOptionMenu a widget used to choose from a list of valid choices. A #GtkOptionMenu is a widget that allows the user to choose from a list 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. Using a #GtkOptionMenu is simple; build a #GtkMenu, by calling gtk_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 with 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 gtk_option_menu_get_history(). The #GtkOptionMenu-struct struct contains private data only, and should be accessed using the functions below. Creates a new #GtkOptionMenu. @Returns: a new #GtkOptionMenu. Returns the #GtkMenu associated with the #GtkOptionMenu. @option_menu: a #GtkOptionMenu. @Returns: the #GtkMenu associated with the #GtkOptionMenu. Provides the #GtkMenu that is popped up to allow the user to choose a new value. You should provide a simple menu avoiding the use of tearoff menu items, submenus, and accelerators. @option_menu: a #GtkOptionMenu. @menu: the #GtkMenu to associate with the #GtkOptionMenu. Removes the menu from the option menu. @option_menu: a #GtkOptionMenu. Selects the menu item specified by @index_ making it the newly selected value for the option menu. @option_menu: a #GtkOptionMenu. @index_: the index of the menu item to select. Index values are from 0 to n-1. @option_menu: @Returns: @optionmenu: the object which received the signal.