Top |
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 () |
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkButton ╰── GtkOptionMenu
GtkOptionMenu implements AtkImplementorIface, GtkBuildable and GtkActivatable.
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.
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.
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.
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.
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.
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.
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.
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.
“indicator-size”
style property“indicator-size” GtkRequisition *
Size of dropdown indicator.
Flags: Read
“indicator-spacing”
style property“indicator-spacing” GtkBorder *
Spacing around indicator.
Flags: Read
“changed”
signalvoid user_function (GtkOptionMenu *optionmenu, gpointer user_data)
optionmenu |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last