ThunarxMenuItem: thunarx Reference Manual

## ThunarxMenuItem ThunarxMenuItem — The base class for menu items added to the context menus |

## Functions

ThunarxMenuItem * | thunarx_menu_item_new ()
gboolean | thunarx_menu_item_activate ()
gboolean | thunarx_menu_item_get_sensitive ()
void | thunarx_menu_item_set_sensitive ()
void | thunarx_menu_item_set_menu ()
void | thunarx_menu_item_list_free ()

## Properties

char * | icon | Read / Write
char * | label | Read / Write
ThunarxMenu * | menu | Read / Write
char * | name | Read / Write / Construct Only
gboolean | priority | Read / Write
gboolean | sensitive | Read / Write
char * | tooltip | Read / Write

## Signals

void | activate | Run Last

## Types and Values

struct | ThunarxMenuItem

## Object Hierarchy

        GObject
        ╰── ThunarxMenuItem

## Includes

    #include <thunarx/thunarx.h>

## Description

The class for menu items that can be added to Thunar's context menus by extensions implementing the ThunarxMenuProvider, ThunarxPreferencesProvider or ThunarxRenamerProvider interfaces. The items returned by extensions from *_get_menu_items() methods are instances of this class or a derived class.

## Functions

### thunarx_menu_item_new ()

    ThunarxMenuItem *
    thunarx_menu_item_new (const gchar *name,
                           const gchar *label,
                           const gchar *tooltip,
                           const gchar *icon);

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

#### Parameters

name | identifier for the menu item |
label | user-visible label of the menu item |
tooltip | tooltip of the menu item |
icon | textual representation of the icon to display in the menu item, as returned by `g_icon_to_string()`. A path or icon name are valid representations too. |

#### Returns

a newly created ThunarxMenuItem

### thunarx_menu_item_activate ()

    gboolean
    thunarx_menu_item_activate (ThunarxMenuItem *item);

Emits the activate signal.

#### Parameters

item | pointer to a ThunarxMenuItem instance |

### thunarx_menu_item_get_sensitive ()

    gboolean
    thunarx_menu_item_get_sensitive (ThunarxMenuItem *item);

Returns whether the menu item is sensitive.

#### Parameters

item | pointer to a ThunarxMenuItem instance |

### thunarx_menu_item_set_sensitive ()

    void
    thunarx_menu_item_set_sensitive (ThunarxMenuItem *item,
                                     gboolean sensitive);

Sets the ::sensitive property of the menu item to `sensitive` .

#### Parameters

item | pointer to a ThunarxMenuItem instance |
sensitive | `TRUE` to make the menu item sensitive |

### thunarx_menu_item_set_menu ()

    void
    thunarx_menu_item_set_menu (ThunarxMenuItem *item,
                                ThunarxMenu *menu);

Attaches `menu` to menu item.

#### Parameters

item | pointer to a ThunarxMenuItem instance |
menu | pointer to a ThunarxMenu instance |

### thunarx_menu_item_list_free ()

    void
    thunarx_menu_item_list_free (GList *items);

#### Parameters

items | a list of ThunarxMenuItem. | [element-type ThunarxMenuItem]

## Types and Values

### struct ThunarxMenuItem

    struct ThunarxMenuItem;

## Property Details

### The `“icon”` property

      “icon”                     char *

Textual representation of the icon (as returned by g_icon_to_string()) to display in the menu item.

Owner: ThunarxMenuItem

Flags: Read / Write

Default value: NULL

### The `“label”` property

      “label”                    char *

Label to display to the user.

Owner: ThunarxMenuItem

Flags: Read / Write

Default value: NULL

### The `“menu”` property

      “menu”                     ThunarxMenu *

The menu belonging to this item. May be null.

Owner: ThunarxMenuItem

Flags: Read / Write

### The `“name”` property

      “name”                     char *

Name of the item.

Owner: ThunarxMenuItem

Flags: Read / Write / Construct Only

Default value: NULL

### The `“priority”` property

      “priority”                 gboolean

Show priority text in toolbars.

Owner: ThunarxMenuItem

Flags: Read / Write

Default value: TRUE

### The `“sensitive”` property

      “sensitive”                gboolean

Whether the menu item is sensitive.

Owner: ThunarxMenuItem

Flags: Read / Write

Default value: TRUE

### The `“tooltip”` property

      “tooltip”                  char *

Tooltip for the menu item.

Owner: ThunarxMenuItem

Flags: Read / Write

Default value: NULL

## Signal Details

### The `“activate”` signal

    void
    user_function (ThunarxMenuItem *thunarxmenuitem,
                   gpointer         user_data)

Flags: Run Last