HeMenuView

HeMenuView — A widget to display a GtkMenu as a series of GtkTreeView columns.

Synopsis

                    HeMenuViewPrivate;
                    HeMenuView;
GtkWidget*          he_menu_view_new                    (void);
void                he_menu_view_set_menu               (HeMenuView *hmv,
                                                         GtkMenu *menu);
GtkWidget*          he_menu_view_get_menu               (HeMenuView *hmv);
GtkWidget*          he_menu_view_get_menu_widget        (HeMenuView *hmv);
void                he_menu_view_set_do_activate        (HeMenuView *hmv,
                                                         gboolean do_activate);
gboolean            he_menu_view_get_do_activate        (HeMenuView *hmv);
void                he_menu_view_popup                  (GtkMenu *menu,
                                                         GtkWindow *parent);
void                he_menu_view_handle_hildon_windows  (void);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkFixed
                                 +----HeMenuView

Implemented Interfaces

HeMenuView implements AtkImplementorIface and GtkBuildable.

Properties

  "do-activate"              gboolean              : Read / Write
  "menu"                     GtkMenu*              : Read / Write
  "menu-widget"              GtkWidget*            : Read

Description

HeMenuView takes a GtkMenu and displays it as a series of columns of GtkTreeView widgets. When the user clicks on a row, the corresponding GtkMenuItem is activated.

Details

HeMenuViewPrivate

typedef struct _HeMenuViewPrivate HeMenuViewPrivate;


HeMenuView

typedef struct _HeMenuView HeMenuView;


he_menu_view_new ()

GtkWidget*          he_menu_view_new                    (void);

Creates a new HeMenuView.

Returns : A new HeMenuView.

Since 0.9.1


he_menu_view_set_menu ()

void                he_menu_view_set_menu               (HeMenuView *hmv,
                                                         GtkMenu *menu);

Set the menu to be displayed by the widget. The widget takes ownership of the GtkMenu, so you can release your reference to it afterwards.

hmv : The HeMenuView
menu : The GtkMenu to display

Since 0.9.1


he_menu_view_get_menu ()

GtkWidget*          he_menu_view_get_menu               (HeMenuView *hmv);

Retrieve the menu being displayed by the widget. The widget owns the GtkMenu, so you must not destroy it.

hmv : The HeMenuView
Returns : The GtkMenu being displayed.

Since 0.9.1


he_menu_view_get_menu_widget ()

GtkWidget*          he_menu_view_get_menu_widget        (HeMenuView *hmv);

Retrieve the GtkMenu widget being displayed.

hmv : The HeMenuView
Returns : The GtkMenu being displayed

Since 0.9.1


he_menu_view_set_do_activate ()

void                he_menu_view_set_do_activate        (HeMenuView *hmv,
                                                         gboolean do_activate);

Set whether clicking a row in one of the HeMenuViewColumn widgets activates the corresponding GtkMenuItem.

hmv : The HeMenuView
do_activate : Whether to activate chosen GtkMenuItem widgets

Since 0.9.1


he_menu_view_get_do_activate ()

gboolean            he_menu_view_get_do_activate        (HeMenuView *hmv);

Retrieve whether clicking a row in one of the HeMenuViewColumn widgets activates the corresponding GtkMenuItem.

hmv : The HeMenuView
Returns : Whether GtkMenuItem widget activation is on

Since 0.9.1


he_menu_view_popup ()

void                he_menu_view_popup                  (GtkMenu *menu,
                                                         GtkWindow *parent);

Pop up a GtkMenu as a HeMenuView in a dialog

menu : The GtkMenu to display
parent : The parent GtkWindow, or NULL

Since 0.9.1


he_menu_view_handle_hildon_windows ()

void                he_menu_view_handle_hildon_windows  (void);

Add a hook to HildonWindow that causes all HildonWindow menus that are GtkMenu widgets to be displayed as HeMenuView widgets. This does not affect the display of HildonAppMenu widgets.

Since 0.9.1

Property Details

The "do-activate" property

  "do-activate"              gboolean              : Read / Write

Whether to activate the GtkMenuItem widget when the corresponding item is chosen.

Default value: TRUE


The "menu" property

  "menu"                     GtkMenu*              : Read / Write

The menu to display.


The "menu-widget" property

  "menu-widget"              GtkWidget*            : Read

The last menu widget that was activated.