|
|
|
GTK+ Reference Manual | |
|---|---|---|---|---|
#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);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----GtkOptionMenu
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.
typedef struct _GtkOptionMenu 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.
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.
| Returns : | a new GtkOptionMenu. |
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.
option_menu : |
a GtkOptionMenu. |
| Returns : | the GtkMenu associated with the GtkOptionMenu. |
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.
option_menu : |
a GtkOptionMenu. |
menu : |
the GtkMenu to associate with the GtkOptionMenu. |
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.
option_menu : |
a GtkOptionMenu. |
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.
option_menu : |
a GtkOptionMenu. |
index_ : |
the index of the menu item to select. Index values are from 0 to n-1. |
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.
option_menu : |
a GtkOptionMenu |
| Returns : | index of the selected menu item, or -1 if there are no menu items |
"indicator-size" style property"indicator-size" GtkRequisition* : Read
Size of dropdown indicator.
"indicator-spacing" style property"indicator-spacing" GtkBorder* : Read
Spacing around indicator.
"changed" signalvoid 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. |