| Top |  |
 |
 |
 |
Functions
| GtkWidget * | gtk_option_menu_new () |
| GtkWidget * | gtk_option_menu_get_menu () |
| void | gtk_option_menu_set_menu () |
| void | gtk_option_menu_remove_menu () |
| void | gtk_option_menu_set_history () |
| gint | gtk_option_menu_get_history () |
Object Hierarchy
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkButton ╰── GtkOptionMenu
Implemented Interfaces
GtkOptionMenu implements AtkImplementorIface, GtkBuildable and GtkActivatable.
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.
Functions
gtk_option_menu_new ()
GtkWidget *
gtk_option_menu_new (void);
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.
gtk_option_menu_get_menu ()
GtkWidget *
gtk_option_menu_get_menu (GtkOptionMenu *option_menu);
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.
gtk_option_menu_set_menu ()
void gtk_option_menu_set_menu (GtkOptionMenu *option_menu,GtkWidget *menu);
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.
gtk_option_menu_remove_menu ()
void
gtk_option_menu_remove_menu (GtkOptionMenu *option_menu);
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.
gtk_option_menu_set_history ()
void gtk_option_menu_set_history (GtkOptionMenu *option_menu,guint index_);
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.
gtk_option_menu_get_history ()
gint
gtk_option_menu_get_history (GtkOptionMenu *option_menu);
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.
Types and Values
struct GtkOptionMenu
struct GtkOptionMenu;
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.
Style Property Details
The “indicator-size” style property
“indicator-size” GtkRequisition *
Size of dropdown indicator.
Flags: Read
The “indicator-spacing” style property
“indicator-spacing” GtkBorder *
Spacing around indicator.
Flags: Read
Signal Details
The “changed” signal
void user_function (GtkOptionMenu *optionmenu, gpointer user_data)
Parameters
optionmenu |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last