XfceAppMenuItem

XfceAppMenuItem — a GtkMenuItem for app launchers.

Synopsis

#include <libxfcegui4/libxfcegui4.h>

                    XfceAppMenuItem;
GtkWidget *         xfce_app_menu_item_new              ();
GtkWidget *         xfce_app_menu_item_new_with_label   (const gchar *label);
GtkWidget *         xfce_app_menu_item_new_with_mnemonic
                                                        (const gchar *label);
GtkWidget *         xfce_app_menu_item_new_with_command (const gchar *label,
                                                         const gchar *command);
GtkWidget *         xfce_app_menu_item_new_full         (const gchar *label,
                                                         const gchar *command,
                                                         const gchar *icon_filename,
                                                         gboolean needs_term,
                                                         gboolean snotify);
GtkWidget *         xfce_app_menu_item_new_from_desktop_entry
                                                        (XfceDesktopEntry *entry,
                                                         gboolean show_icon);
void                xfce_app_menu_item_set_name         (XfceAppMenuItem *app_menu_item,
                                                         const gchar *name);
void                xfce_app_menu_item_set_icon_name    (XfceAppMenuItem *app_menu_item,
                                                         const gchar *filename);
void                xfce_app_menu_item_set_command      (XfceAppMenuItem *app_menu_item,
                                                         const gchar *command);
void                xfce_app_menu_item_set_needs_term   (XfceAppMenuItem *app_menu_item,
                                                         gboolean needs_term);
void                xfce_app_menu_item_set_startup_notification
                                                        (XfceAppMenuItem *app_menu_item,
                                                         gboolean snotify);
#define             xfce_app_menu_item_set_image        (mi,
                                                         img)
const gchar *       xfce_app_menu_item_get_name         (XfceAppMenuItem *app_menu_item);
const gchar *       xfce_app_menu_item_get_icon_name    (XfceAppMenuItem *app_menu_item);
const gchar *       xfce_app_menu_item_get_command      (XfceAppMenuItem *app_menu_item);
gboolean            xfce_app_menu_item_get_needs_term   (XfceAppMenuItem *app_menu_item);
gboolean            xfce_app_menu_item_get_startup_notification
                                                        (XfceAppMenuItem *app_menu_item);
#define             xfce_app_menu_item_get_image        (mi)
void                xfce_app_menu_item_set_icon_size    (guint icon_size);
void                xfce_app_menu_item_set_icon_theme_name
                                                        (const gchar *theme_name);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkItem
                                       +----GtkMenuItem
                                             +----GtkImageMenuItem
                                                   +----XfceAppMenuItem

Implemented Interfaces

XfceAppMenuItem implements AtkImplementorIface, GtkBuildable and GtkActivatable.

Properties

  "command"                  gchar*                : Read / Write
  "icon-name"                gchar*                : Read / Write
  "label"                    gchar*                : Read / Write
  "needs-term"               gboolean              : Read / Write
  "snotify"                  gboolean              : Read / Write
  "use-underline"            gboolean              : Read / Write

Description

XfceAppMenuItem is a direct subclass of GtkImageMenuItem, and is intended for use in application menus. XfceAppMenuItem essentially wraps an application: it knows how to run the application, what it is called, and what icon is used to represent it. An XfceAppMenuItem can also be generated directly from an XfceDesktopEntry.

Details

XfceAppMenuItem

typedef struct _XfceAppMenuItem XfceAppMenuItem;


xfce_app_menu_item_new ()

GtkWidget *         xfce_app_menu_item_new              ();

Creates a new XfceAppMenuItem with an empty label.

Since 4.1

Returns :

A new XfceAppMenuItem.

xfce_app_menu_item_new_with_label ()

GtkWidget *         xfce_app_menu_item_new_with_label   (const gchar *label);

Creates a new XfceAppMenuItem containing a label.

Since 4.1

label :

The text of the menu item.

Returns :

A new XfceAppMenuItem.

xfce_app_menu_item_new_with_mnemonic ()

GtkWidget *         xfce_app_menu_item_new_with_mnemonic
                                                        (const gchar *label);

Creates a new XfceAppMenuItem 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.

Since 4.1

label :

The text of the menu item, with an underscore in front of the mnemonic character.

Returns :

A new XfceAppMenuItem.

xfce_app_menu_item_new_with_command ()

GtkWidget *         xfce_app_menu_item_new_with_command (const gchar *label,
                                                         const gchar *command);

Creates a new XfceAppMenuItem containing a label. The item's activate signal will be connected such that command will run when it is clicked.

Since 4.1

label :

The text of the menu item.

command :

The command associated with the menu item.

Returns :

A new XfceAppMenuItem.

xfce_app_menu_item_new_full ()

GtkWidget *         xfce_app_menu_item_new_full         (const gchar *label,
                                                         const gchar *command,
                                                         const gchar *icon_filename,
                                                         gboolean needs_term,
                                                         gboolean snotify);

Single-function interface to create an XfceAppMenuItem. Has the effect of calling xfce_app_menu_item_new_with_label() followed by all the xfce_app_menu_item_set_*() functions.

Since 4.1

label :

The text of the menu item.

command :

The command associated with the menu item.

icon_filename :

The filename of the icon.

needs_term :

TRUE if the application needs a terminal, FALSE if not.

snotify :

TRUE if the application supports startup notification, FALSE if not.

Returns :

A new XfceAppMenuItem.

xfce_app_menu_item_new_from_desktop_entry ()

GtkWidget *         xfce_app_menu_item_new_from_desktop_entry
                                                        (XfceDesktopEntry *entry,
                                                         gboolean show_icon);

Creates a new XfceAppMenuItem using parameters from the application specified in a XfceDesktopEntry object. This has the effect of calling xfce_app_menu_item_new_with_command(), xfce_app_menu_item_set_needs_term(), xfce_app_menu_item_set_icon_name(), and xfce_app_menu_item_set_startup_notification().

Since 4.1

entry :

An XfceDesktopEntry describing the menu item to create.

show_icon :

Sets whether or not to show an icon in the menu item.

Returns :

A new XfceAppMenuItem, or NULL on error.

xfce_app_menu_item_set_name ()

void                xfce_app_menu_item_set_name         (XfceAppMenuItem *app_menu_item,
                                                         const gchar *name);

Sets name as the displayed name of the XfceAppMenuItem.

Since 4.1

app_menu_item :

An XfceAppMenuItem.

name :

The name of the menu item the menu item.

xfce_app_menu_item_set_icon_name ()

void                xfce_app_menu_item_set_icon_name    (XfceAppMenuItem *app_menu_item,
                                                         const gchar *filename);

Sets the icon of the XfceAppMenuItem using the specified filename. If the filename doesn't have a full pathname, standard icon search paths will be used. If the filename doesn't have an extension, the best image format found (if any) will be used. If there is already an icon set, the current one is freed, regardless if the icon is found or not.

Since 4.1

app_menu_item :

an XfceAppMenuItem.

filename :

The filename of the icon.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu item.

xfce_app_menu_item_set_:

The command associated with the menu