| Maintainer | gtk2hs-users@lists.sourceforge.net |
|---|---|
| Stability | provisional |
| Portability | portable (depends on GHC) |
| Safe Haskell | None |
| Language | Haskell98 |
Graphics.UI.Gtk.MenuComboToolbar.OptionMenu
Description
A widget used to choose from a list of valid choices
- Warning: this module is deprecated and should not be used in newly-written code. It is empty in Gtk3.
- data OptionMenu
- class ButtonClass o => OptionMenuClass o
- castToOptionMenu :: GObjectClass obj => obj -> OptionMenu
- gTypeOptionMenu :: GType
- toOptionMenu :: OptionMenuClass o => o -> OptionMenu
- optionMenuNew :: IO OptionMenu
- optionMenuGetMenu :: OptionMenuClass self => self -> IO Menu
- optionMenuSetMenu :: (OptionMenuClass self, MenuClass menu) => self -> menu -> IO ()
- optionMenuRemoveMenu :: OptionMenuClass self => self -> IO ()
- optionMenuSetHistory :: OptionMenuClass self => self -> Int -> IO ()
- optionMenuGetHistory :: OptionMenuClass self => self -> IO Int
- optionMenuMenu :: (OptionMenuClass self, MenuClass menu) => ReadWriteAttr self Menu menu
- onOMChanged :: OptionMenuClass self => self -> IO () -> IO (ConnectId self)
- afterOMChanged :: OptionMenuClass self => self -> IO () -> IO (ConnectId self)
Detail
A OptionMenu is a widget that allows the user to choose from a list of
valid choices. The OptionMenu displays the selected choice. When activated
the OptionMenu displays a popup Menu which allows the user to make a new
choice.
Using a OptionMenu is simple; build a Menu, by calling
menuNew, then appending menu items
to it with menuShellAppend.
Set that menu on the option menu with optionMenuSetMenu. Set the selected
menu item with optionMenuSetHistory; connect to the "changed" signal on
the option menu; in the "changed" signal, check the new selected menu
item with optionMenuGetHistory.
As of Gtk+ 2.4, OptionMenu has been deprecated in favor of ComboBox.
Class Hierarchy
Types
data OptionMenu Source
class ButtonClass o => OptionMenuClass o Source
Instances
castToOptionMenu :: GObjectClass obj => obj -> OptionMenu Source
toOptionMenu :: OptionMenuClass o => o -> OptionMenu Source
Constructors
optionMenuNew :: IO OptionMenu Source
Create a new option menu.
Methods
optionMenuGetMenu :: OptionMenuClass self => self -> IO Menu Source
Returns the Menu associated with the OptionMenu.
optionMenuSetMenu :: (OptionMenuClass self, MenuClass menu) => self -> menu -> IO () Source
Provides the 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.
optionMenuRemoveMenu :: OptionMenuClass self => self -> IO () Source
Removes the menu from the option menu.
Arguments
| :: OptionMenuClass self | |
| => self | |
| -> Int |
|
| -> IO () |
Selects the menu item specified by index making it the newly selected
value for the option menu.
Arguments
| :: OptionMenuClass self | |
| => self | |
| -> IO Int | returns index of the selected menu item, or -1 if there are no menu items |
Retrieves the index of the currently selected menu item. The menu items are numbered from top to bottom, starting with 0.
Attributes
optionMenuMenu :: (OptionMenuClass self, MenuClass menu) => ReadWriteAttr self Menu menu Source
The menu of options.
Signals
onOMChanged :: OptionMenuClass self => self -> IO () -> IO (ConnectId self) Source
This signal is called if the selected option has changed.
afterOMChanged :: OptionMenuClass self => self -> IO () -> IO (ConnectId self) Source
This signal is called if the selected option has changed.