## NautilusMenuItem

NautilusMenuItem

## Synopsis

    #define             NAUTILUS_TYPE_MENU_ITEM
    #define             NAUTILUS_MENU_ITEM                  (obj)
    #define             NAUTILUS_MENU_ITEM_CLASS            (klass)
    #define             NAUTILUS_MENU_IS_ITEM               (obj)
    #define             NAUTILUS_MENU_IS_ITEM_CLASS         (klass)
    #define             NAUTILUS_MENU_ITEM_GET_CLASS        (obj)
                        NautilusMenuPrivate;
                        NautilusMenuItemDetails;
    struct              NautilusMenu;
    struct              NautilusMenuItem;
    NautilusMenu *	     nautilus_menu_new                   (void);
    void                nautilus_menu_append_item           (NautilusMenu *menu,
                                                             NautilusMenuItem *item);
    GList *	            nautilus_menu_get_items             (NautilusMenu *menu);
    void                nautilus_menu_item_list_free        (GList *item_list);
    GType               nautilus_menu_item_get_type         (void);
    NautilusMenuItem *  nautilus_menu_item_new              (const char *name,
                                                             const char *label,
                                                             const char *tip,
                                                             const char *icon);
    void                nautilus_menu_item_activate         (NautilusMenuItem *item);
    void                nautilus_menu_item_set_submenu      (NautilusMenuItem *item,
                                                             NautilusMenu *menu);

## Object Hierarchy

      GObject
       +----NautilusMenu

      GObject
       +----NautilusMenuItem

## Properties

      "icon"                     gchar*                : Read / Write
      "label"                    gchar*                : Read / Write
      "menu"                     NautilusMenu*         : Read / Write
      "name"                     gchar*                : Read / Write / Construct Only
      "priority"                 gboolean              : Read / Write
      "sensitive"                gboolean              : Read / Write
      "tip"                      gchar*                : Read / Write

## Signals

      "activate"                                       : Run Last

## Description

## Details

### NAUTILUS_TYPE_MENU_ITEM

    #define NAUTILUS_TYPE_MENU_ITEM            (nautilus_menu_item_get_type())

### NAUTILUS_MENU_ITEM()

    #define NAUTILUS_MENU_ITEM(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), NAUTILUS_TYPE_MENU_ITEM, NautilusMenuItem))

### NAUTILUS_MENU_ITEM_CLASS()

    #define NAUTILUS_MENU_ITEM_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), NAUTILUS_TYPE_MENU_ITEM, NautilusMenuItemClass))

### NAUTILUS_MENU_IS_ITEM()

    #define NAUTILUS_MENU_IS_ITEM(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), NAUTILUS_TYPE_MENU_ITEM))

### NAUTILUS_MENU_IS_ITEM_CLASS()

    #define NAUTILUS_MENU_IS_ITEM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((obj), NAUTILUS_TYPE_MENU_ITEM))

### NAUTILUS_MENU_ITEM_GET_CLASS()

    #define NAUTILUS_MENU_ITEM_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS((obj), NAUTILUS_TYPE_MENU_ITEM, NautilusMenuItemClass))

### NautilusMenuPrivate

    typedef struct _NautilusMenuPrivate NautilusMenuPrivate;

### NautilusMenuItemDetails

    typedef struct _NautilusMenuItemDetails NautilusMenuItemDetails;

### struct NautilusMenu

    struct NautilusMenu;

### struct NautilusMenuItem

    struct NautilusMenuItem;

### nautilus_menu_new ()

    NautilusMenu *	     nautilus_menu_new                   (void);

### nautilus_menu_append_item ()

    void                nautilus_menu_append_item           (NautilusMenu *menu,
                                                             NautilusMenuItem *item);

### nautilus_menu_get_items ()

    GList *	            nautilus_menu_get_items             (NautilusMenu *menu);

### nautilus_menu_item_list_free ()

    void                nautilus_menu_item_list_free        (GList *item_list);

### nautilus_menu_item_get_type ()

    GType               nautilus_menu_item_get_type         (void);

### nautilus_menu_item_new ()

    NautilusMenuItem *  nautilus_menu_item_new              (const char *name,
                                                             const char *label,
                                                             const char *tip,
                                                             const char *icon);

Creates a new menu item that can be added to the toolbar or to a contextual menu.

`name` : | the identifier for the menu item
`label` : | the user-visible label of the menu item
`tip` : | the tooltip of the menu item
`icon` : | the name of the icon to display in the menu item
Returns : | a newly create NautilusMenuItem

### nautilus_menu_item_activate ()

    void                nautilus_menu_item_activate         (NautilusMenuItem *item);

emits the activate signal.

`item` : | pointer to a NautilusMenuItem

### nautilus_menu_item_set_submenu ()

    void                nautilus_menu_item_set_submenu      (NautilusMenuItem *item,
                                                             NautilusMenu *menu);

Attachs a menu to the given NautilusMenuItem.

`item` : | pointer to a NautilusMenuItem
`menu` : | pointer to a NautilusMenu to attach to the button

## Property Details

### The `"icon"` property

      "icon"                     gchar*                : Read / Write

Name of the icon to display in the menu item.

Default value: NULL

### The `"label"` property

      "label"                    gchar*                : Read / Write

Label to display to the user.

Default value: NULL

### The `"menu"` property

      "menu"                     NautilusMenu*         : Read / Write

The menu belonging to this item. May be null.

### The `"name"` property

      "name"                     gchar*                : Read / Write / Construct Only

Name of the item.

Default value: NULL

### The `"priority"` property

      "priority"                 gboolean              : Read / Write

Show priority text in toolbars.

Default value: TRUE

### The `"sensitive"` property

      "sensitive"                gboolean              : Read / Write

Whether the menu item is sensitive.

Default value: TRUE

### The `"tip"` property

      "tip"                      gchar*                : Read / Write

Tooltip for the menu item.

Default value: NULL

## Signal Details

### The `"activate"` signal

    void                user_function                      (NautilusMenuItem *nautilusmenuitem,
                                                            gpointer          user_data)             : Run Last

`nautilusmenuitem` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.