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.
Class Methods
Gtk::OptionMenu.new
-
Creates a new Gtk::OptionMenu.
- Returns: a new Gtk::OptionMenu.
Instance Methods
menu
-
Returns the Gtk::Menu associated with the Gtk::OptionMenu.
- 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.
- menu: the Gtk::Menu to associate with the Gtk::OptionMenu.
- Returns: menu
set_menu(menu)
-
Same as Gtk::OptionMenu#menu=.
- menu: the Gtk::Menu to associate with the Gtk::OptionMenu.
- Returns: self
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.
Properties
menu: Gtk::Menu (Read/Write)
- The menu of options.
Style Properties
indicator-size: Gtk::Requisition (Read)
- Size of dropdown indicator
indicator-spacing: Gtk::Border (Read)
- Spacing around indicator
Keyword(s):
References:[ruby-gtk-object-hierarchy] [News_20040810_1] [Gtk::RadioButton] [index-ruby-gtk2] [Gtk::FileSelection] [Gtk::Label] [api-gtk-index] [Gtk::ComboBox] [Gtk::ItemFactory] [Gtk::Menu] [Gtk::OptionMenu]