## GtkOptionMenu

GtkOptionMenu — A widget used to choose from a list of valid choices

## Synopsis

    #include <gtk/gtk.h>

                        GtkOptionMenu;
    GtkWidget*          gtk_option_menu_new                 (void);
    GtkWidget*          gtk_option_menu_get_menu            (GtkOptionMenu *option_menu);
    void                gtk_option_menu_set_menu            (GtkOptionMenu *option_menu,
                                                             GtkWidget *menu);
    void                gtk_option_menu_remove_menu         (GtkOptionMenu *option_menu);
    void                gtk_option_menu_set_history         (GtkOptionMenu *option_menu,
                                                             guint index_);
    gint                gtk_option_menu_get_history         (GtkOptionMenu *option_menu);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkButton
                                           +----GtkOptionMenu

## Implemented Interfaces

GtkOptionMenu implements AtkImplementorIface and GtkBuildable.

## Properties

      "menu"                     GtkMenu               : Read / Write

## Style Properties

      "indicator-size"           GtkRequisition        : Read
      "indicator-spacing"        GtkBorder             : Read

## Signals

      "changed"                                        : Run Last

## Description

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

As of GTK+ 2.4, GtkOptionMenu has been deprecated in favor of GtkComboBox.

## Details

### GtkOptionMenu

    typedef struct _GtkOptionMenu GtkOptionMenu;

### Warning

`GtkOptionMenu` has been deprecated since version 2.4 and should not be used in newly-written code. Use GtkComboBox instead.

The GtkOptionMenu struct contains private data only, and should be accessed using the functions below.

### gtk_option_menu_new ()

    GtkWidget*          gtk_option_menu_new                 (void);

### Warning

`gtk_option_menu_new` has been deprecated since version 2.4 and should not be used in newly-written code. Use GtkComboBox instead.

Creates a new GtkOptionMenu.

Returns : | a new GtkOptionMenu.

### gtk_option_menu_get_menu ()

    GtkWidget*          gtk_option_menu_get_menu            (GtkOptionMenu *option_menu);

### Warning

`gtk_option_menu_get_menu` has been deprecated since version 2.4 and should not be used in newly-written code. Use GtkComboBox instead.

Returns the GtkMenu associated with the GtkOptionMenu.

`option_menu` : | a GtkOptionMenu.
Returns : | the GtkMenu associated with the GtkOptionMenu.

### gtk_option_menu_set_menu ()

    void                gtk_option_menu_set_menu            (GtkOptionMenu *option_menu,
                                                             GtkWidget *menu);

### Warning

`gtk_option_menu_set_menu` has been deprecated since version 2.4 and should not be used in newly-written code. Use GtkComboBox instead.

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.

### gtk_option_menu_remove_menu ()

    void                gtk_option_menu_remove_menu         (GtkOptionMenu *option_menu);

### Warning

`gtk_option_menu_remove_menu` has been deprecated since version 2.4 and should not be used in newly-written code. Use GtkComboBox instead.

Removes the menu from the option menu.

`option_menu` : | a GtkOptionMenu.

### gtk_option_menu_set_history ()

    void                gtk_option_menu_set_history         (GtkOptionMenu *option_menu,
                                                             guint index_);

### Warning

`gtk_option_menu_set_history` has been deprecated since version 2.4 and should not be used in newly-written code. Use GtkComboBox instead.

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.

### gtk_option_menu_get_history ()

    gint                gtk_option_menu_get_history         (GtkOptionMenu *option_menu);

### Warning

`gtk_option_menu_get_history` has been deprecated since version 2.4 and should not be used in newly-written code. Use GtkComboBox instead.

Retrieves the index of the currently selected menu item. The menu items are numbered from top to bottom, starting with 0.

`option_menu` : | a GtkOptionMenu
Returns : | index of the selected menu item, or -1 if there are no menu items

## Property Details

### The "`menu`" property

      "menu"                     GtkMenu               : Read / Write

The menu of options.

## Style Property Details

### The "`indicator-size`" style property

      "indicator-size"           GtkRequisition        : Read

Size of dropdown indicator.

### The "`indicator-spacing`" style property

      "indicator-spacing"        GtkBorder             : Read

Spacing around indicator.

## Signal Details

### The "changed" signal

    void                user_function                      (GtkOptionMenu *optionmenu,
                                                            gpointer       user_data)       : Run Last

`optionmenu` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.