| Top |
| GtkWidget * | gtk_menu_item_new () |
| GtkWidget * | gtk_menu_item_new_with_label () |
| GtkWidget * | gtk_menu_item_new_with_mnemonic () |
| void | gtk_menu_item_set_right_justified () |
| gboolean | gtk_menu_item_get_right_justified () |
| const gchar * | gtk_menu_item_get_label () |
| void | gtk_menu_item_set_label () |
| gboolean | gtk_menu_item_get_use_underline () |
| void | gtk_menu_item_set_use_underline () |
| void | gtk_menu_item_set_submenu () |
| GtkWidget * | gtk_menu_item_get_submenu () |
| void | gtk_menu_item_remove_submenu () |
| void | gtk_menu_item_set_accel_path () |
| const gchar * | gtk_menu_item_get_accel_path () |
| void | gtk_menu_item_select () |
| void | gtk_menu_item_deselect () |
| void | gtk_menu_item_activate () |
| void | gtk_menu_item_toggle_size_request () |
| void | gtk_menu_item_toggle_size_allocate () |
| #define | gtk_menu_item_right_justify() |
| gchar * | accel-path | Read / Write |
| gchar * | label | Read / Write |
| gboolean | right-justified | Read / Write |
| GtkMenu * | submenu | Read / Write |
| gboolean | use-underline | Read / Write |
| gfloat | arrow-scaling | Read |
| gint | arrow-spacing | Read |
| gint | horizontal-padding | Read |
| GtkShadowType | selected-shadow-type | Read |
| gint | toggle-spacing | Read |
| gint | width-chars | Read |
| void | activate | Action |
| void | activate-item | Run First |
| void | toggle-size-allocate | Run First |
| void | toggle-size-request | Run First |
GObject
╰── GInitiallyUnowned
╰── GtkObject
╰── GtkWidget
╰── GtkContainer
╰── GtkBin
╰── GtkItem
╰── GtkMenuItem
├── GtkCheckMenuItem
├── GtkImageMenuItem
├── GtkSeparatorMenuItem
╰── GtkTearoffMenuItem
GtkWidget *
gtk_menu_item_new_with_mnemonic (const gchar *label);
Creates a new GtkMenuItem containing a label. The label
will be created using gtk_label_new_with_mnemonic(), so underscores
in label
indicate the mnemonic for the menu item.
label |
The text of the button, with an underscore in front of the mnemonic character |
|
returns |
a new GtkMenuItem |
void gtk_menu_item_set_right_justified (GtkMenuItem *menu_item,gboolean right_justified);
Sets whether the menu item appears justified at the right side of a menu bar. This was traditionally done for "Help" menu items, but is now considered a bad idea. (If the widget layout is reversed for a right-to-left language like Hebrew or Arabic, right-justified-menu-items appear at the left.)
menu_item |
a GtkMenuItem. |
|
right_justified |
if |
gboolean
gtk_menu_item_get_right_justified (GtkMenuItem *menu_item);
Gets whether the menu item appears justified at the right side of the menu bar.
const gchar *
gtk_menu_item_get_label (GtkMenuItem *menu_item);
Sets text
on the menu_item
label
The text in the menu_item
label. This is the internal
string used by the label, and must not be modified.
Since: 2.16
void gtk_menu_item_set_label (GtkMenuItem *menu_item,const gchar *label);
Sets text
on the menu_item
label
Since: 2.16
gboolean
gtk_menu_item_get_use_underline (GtkMenuItem *menu_item);
Checks if an underline in the text indicates the next character should be used for the mnemonic accelerator key.
Since: 2.16
void gtk_menu_item_set_use_underline (GtkMenuItem *menu_item,gboolean setting);
If true, an underline in the text indicates the next character should be used for the mnemonic accelerator key.
Since: 2.16
void gtk_menu_item_set_submenu (GtkMenuItem *menu_item,GtkWidget *submenu);
Sets or replaces the menu item's submenu, or removes it when a NULL
submenu is passed.
GtkWidget *
gtk_menu_item_get_submenu (GtkMenuItem *menu_item);
Gets the submenu underneath this menu item, if any.
See gtk_menu_item_set_submenu().
void
gtk_menu_item_remove_submenu (GtkMenuItem *menu_item);
gtk_menu_item_remove_submenu has been deprecated since version 2.12 and should not be used in newly-written code.
gtk_menu_item_remove_submenu() is deprecated and
should not be used in newly written code. Use
gtk_menu_item_set_submenu() instead.
Removes the widget's submenu.
void gtk_menu_item_set_accel_path (GtkMenuItem *menu_item,const gchar *accel_path);
Set the accelerator path on menu_item
, through which runtime changes of the
menu item's accelerator caused by the user can be identified and saved to
persistant storage (see gtk_accel_map_save() on this).
To setup a default accelerator for this menu item, call
gtk_accel_map_add_entry() with the same accel_path
.
See also gtk_accel_map_add_entry() on the specifics of accelerator paths,
and gtk_menu_set_accel_path() for a more convenient variant of this function.
This function is basically a convenience wrapper that handles calling
gtk_widget_set_accel_path() with the appropriate accelerator group for
the menu item.
Note that you do need to set an accelerator on the parent menu with
gtk_menu_set_accel_group() for this to work.
Note that accel_path
string will be stored in a GQuark. Therefore, if you
pass a static string, you can save some memory by interning it first with
g_intern_static_string().
menu_item |
a valid GtkMenuItem |
|
accel_path |
accelerator path, corresponding to this menu item's
functionality, or |
[allow-none] |
const gchar *
gtk_menu_item_get_accel_path (GtkMenuItem *menu_item);
Retrieve the accelerator path that was previously set on menu_item
.
See gtk_menu_item_set_accel_path() for details.
Since: 2.14
void gtk_menu_item_toggle_size_request (GtkMenuItem *menu_item,gint *requisition);
void gtk_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,gint allocation);
“accel-path” property “accel-path” gchar *
Sets the accelerator path of the menu item, through which runtime changes of the menu item's accelerator caused by the user can be identified and saved to persistant storage.
Flags: Read / Write
Default value: NULL
Since: 2.14
“label” property “label” gchar *
The text for the child label.
Flags: Read / Write
Default value: ""
Since: 2.16
“right-justified” property “right-justified” gboolean
Sets whether the menu item appears justified at the right side of a menu bar.
Flags: Read / Write
Default value: FALSE
Since: 2.14
“submenu” property“submenu” GtkMenu *
The submenu attached to the menu item, or NULL if it has none.
Flags: Read / Write
Since: 2.12
“use-underline” property “use-underline” gboolean
TRUE if underlines in the text indicate mnemonics
Flags: Read / Write
Default value: FALSE
Since: 2.16
“arrow-scaling” style property “arrow-scaling” gfloat
Amount of space used up by arrow, relative to the menu item's font size.
Flags: Read
Allowed values: [0,2]
Default value: 0.8
“arrow-spacing” style property “arrow-spacing” gint
Space between label and arrow.
Flags: Read
Allowed values: >= 0
Default value: 10
“horizontal-padding” style property “horizontal-padding” gint
Padding to left and right of the menu item.
Flags: Read
Allowed values: >= 0
Default value: 3
“selected-shadow-type” style property“selected-shadow-type” GtkShadowType
Shadow type when item is selected.
Flags: Read
Default value: GTK_SHADOW_NONE
“toggle-spacing” style property “toggle-spacing” gint
Space between icon and label.
Flags: Read
Allowed values: >= 0
Default value: 5
“width-chars” style property “width-chars” gint
The minimum desired width of the menu item in characters.
Flags: Read
Allowed values: >= 0
Default value: 12
Since: 2.14
“activate-item” signalvoid user_function (GtkMenuItem *menuitem, gpointer user_data)
Flags: Run First
“toggle-size-allocate” signalvoid user_function (GtkMenuItem *menuitem, gint arg1, gpointer user_data)
Flags: Run First
“toggle-size-request” signalvoid user_function (GtkMenuItem *menuitem, gpointer arg1, gpointer user_data)
Flags: Run First