Create  Edit  FrontPage  Index  Search  Changes  History  RSS  Login

Gtk::OptionMenu

class Gtk::OptionMenu

A Gtk::OptionMenu is a widget that allows the user to choose from a list of valid choices. The Gtk::OptionMenu displays the selected choice. When activated the Gtk::OptionMenu displays a popup Gtk::Menu which allows the user to make a new choice.

Using a Gtk::OptionMenu is simple; build a Gtk::Menu, by calling Gtk::Menu.new, then appending menu items to it with Gtk::MenuShell#append. Set that menu on the option menu with Gtk::OptionMenu#menu=. Set the selected menu item with Gtk::OptionMenu#history=; connect to the "changed" signal on the option menu; in the "changed" signal, check the new selected menu item with Gtk::OptionMenu#history.

Instance Methods

menu
Returns the Gtk::Menu associated with the Gtk::OptionMenu.
menu=(menu)
Provides the Gtk::Menu 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.
set_menu(menu)
Same as Gtk::OptionMenu#menu=.
remove_menu
Removes the menu from the option menu.
  • Returns: self
history
Retrieves the index of the currently selected menu item. The menu items are numbered from top to bottom, starting with 0.
  • Returns: index of the selected menu item, or -1 if there are no menu items
history=(index)
Selects the menu item specified by index making it the newly selected value for the option menu.
  • index: the index of the menu item to select. Index values are from 0 to n-1.
  • Returns: index
set_history(index)
Same as Gtk::OptionMenu#history=.
  • index: the index of the menu item to select. Index values are from 0 to n-1.
  • Returns: self
ref_accessible
See Atk::Implementor#ref_accessible.
add_child
See Gtk::Buildable#add_child.
construct_child
See Gtk::Buildable#construct_child.
get_internal_child
See Gtk::Buildable#get_internal_child.
name
See Gtk::Buildable#name.
name=
See Gtk::Buildable#name=.
set_buildable_property
See Gtk::Buildable#set_buildable_property.
set_name
See Gtk::Buildable#set_name.
builder_name
See Gtk::Buildable#builder_name.
builder_name=
See Gtk::Buildable#builder_name=.
set_builder_name
See Gtk::Buildable#set_builder_name.