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 HierarchyGObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----GtkOptionMenu DescriptionA 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
As of GTK+ 2.4, GtkOptionMenu has been deprecated in favor of GtkComboBox. DetailsGtkOptionMenutypedef struct _GtkOptionMenu GtkOptionMenu; Warning
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
Creates a new GtkOptionMenu.
gtk_option_menu_get_menu ()GtkWidget* gtk_option_menu_get_menu (GtkOptionMenu *option_menu); Warning
Returns the GtkMenu associated with the GtkOptionMenu.
gtk_option_menu_set_menu ()void gtk_option_menu_set_menu (GtkOptionMenu *option_menu, GtkWidget *menu); Warning
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); Warning
Removes the menu from the option menu.
gtk_option_menu_set_history ()void gtk_option_menu_set_history (GtkOptionMenu *option_menu, guint index_); Warning
Selects the menu item specified by
gtk_option_menu_get_history ()gint gtk_option_menu_get_history (GtkOptionMenu *option_menu); Warning
Retrieves the index of the currently selected menu item. The menu items are numbered from top to bottom, starting with 0.
Style Property DetailsThe
|
|
the object which received the signal. |
|
user data set when the signal handler was connected. |