Graphics.UI.Gtk.MenuComboToolbar.OptionMenu

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.

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

| GObject
| +----Object
| +----Widget
| +----Container
| +----Bin
| +----Button
| +----OptionMenu

Types

data OptionMenu

Instances

Eq OptionMenu

Ord OptionMenu

GObjectClass OptionMenu

OptionMenuClass OptionMenu

ButtonClass OptionMenu

BinClass OptionMenu

ContainerClass OptionMenu

WidgetClass OptionMenu

ObjectClass OptionMenu

class ButtonClass o => OptionMenuClass o

Instances

OptionMenuClass OptionMenu

castToOptionMenu :: GObjectClass obj => obj -> OptionMenu

gTypeOptionMenu :: GType

toOptionMenu :: OptionMenuClass o => o -> OptionMenu

Constructors

optionMenuNew :: IO OptionMenu

Create a new option menu.

Methods

optionMenuGetMenu :: OptionMenuClass self => self -> IO Menu

Returns the Menu associated with the OptionMenu.

optionMenuSetMenu :: (OptionMenuClass self, MenuClass menu) => self -> menu -> IO ()

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 ()

Removes the menu from the option menu.

optionMenuSetHistory

Arguments

:: OptionMenuClass self

=> self

-> Int

index - the index of the menu item to select. Index values are from 0 to n-1.

-> IO ()

Selects the menu item specified by index making it the newly selected value for the option menu.

optionMenuGetHistory

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

The menu of options.

Signals

onOMChanged :: OptionMenuClass self => self -> IO () -> IO (ConnectId self)

This signal is called if the selected option has changed.

afterOMChanged :: OptionMenuClass self => self -> IO () -> IO (ConnectId self)

This signal is called if the selected option has changed.