GTK+ Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
#include <gtk/gtk.h> struct GtkMenuItem; GtkWidget* gtk_menu_item_new (void); GtkWidget* gtk_menu_item_new_with_label (const gchar *label); void gtk_menu_item_set_submenu (GtkMenuItem *menu_item, GtkWidget *submenu); void gtk_menu_item_remove_submenu (GtkMenuItem *menu_item); void gtk_menu_item_set_placement (GtkMenuItem *menu_item, GtkSubmenuPlacement placement); void gtk_menu_item_configure (GtkMenuItem *menu_item, gint show_toggle_indicator, gint show_submenu_indicator); void gtk_menu_item_select (GtkMenuItem *menu_item); void gtk_menu_item_deselect (GtkMenuItem *menu_item); void gtk_menu_item_activate (GtkMenuItem *menu_item); void gtk_menu_item_right_justify (GtkMenuItem *menu_item); |
GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkItem +----GtkMenuItem |
"activate" void user_function (GtkMenuItem *menuitem, gpointer user_data); "activate-item" void user_function (GtkMenuItem *menuitem, gpointer user_data); |
The GtkMenuItem widget and the derived widgets are the only valid childs for menus. Their function is to correctly handle highlighting, alignment, events and submenus.
As it derives from GtkBin it can hold any valid child widget, altough only a few are really useful.
GtkWidget* gtk_menu_item_new (void); |
Creates a new GtkMenuItem.
Returns : | the newly created GtkMenuItem |
GtkWidget* gtk_menu_item_new_with_label (const gchar *label); |
Creates a new GtkMenuItem whose child is a simple GtlLabel.
label : | the text for the label |
Returns : | the newly created GtkMenuItem |
void gtk_menu_item_set_submenu (GtkMenuItem *menu_item, GtkWidget *submenu); |
Sets the widget submenu, or changes it.
void gtk_menu_item_remove_submenu (GtkMenuItem *menu_item); |
Removes the widget's submenu.
void gtk_menu_item_set_placement (GtkMenuItem *menu_item, GtkSubmenuPlacement placement); |
Specifies the placement of the submenu around the menu item. The placement is usually GTK_LEFT_RIGHT for menu items in a popup menu and GTK_TOP_BOTTOM in menu bars.
This function is useless in usual applications.
void gtk_menu_item_configure (GtkMenuItem *menu_item, gint show_toggle_indicator, gint show_submenu_indicator); |
Sets whether the menu item should show a submenu indicator, which is a right arrow.
void gtk_menu_item_select (GtkMenuItem *menu_item); |
Emits the "select" signal on the given item. Behaves exactly like gtk_item_select.
void gtk_menu_item_deselect (GtkMenuItem *menu_item); |
Emits the "deselect" signal on the given item. Behaves exactly like gtk_item_deselect.
void gtk_menu_item_activate (GtkMenuItem *menu_item); |
Emits the "activate" signal on the given item
void gtk_menu_item_right_justify (GtkMenuItem *menu_item); |
Sets the menu item to be right-justified. Only useful for menu bars.
void user_function (GtkMenuItem *menuitem, gpointer user_data); |
Emitted when the item is activated.
void user_function (GtkMenuItem *menuitem, gpointer user_data); |
Emitted when the item is activated, but also if the menu item has a submenu. For normal applications, the relevant signal is "activate".
for how to handle the child.
is the abstract class for all sorts of items.
is always the parent of GtkMenuItem.