BrowserPerspective

BrowserPerspective — A "perspective" in a BrowserWindow window

Synopsis

#define             BROWSER_PERSPECTIVE_TYPE
#define             BROWSER_PERSPECTIVE                 (obj)
#define             IS_BROWSER_PERSPECTIVE              (obj)
#define             BROWSER_PERSPECTIVE_GET_CLASS       (obj)
                    BrowserPerspective;
GType               browser_perspective_get_type        (void);
GtkActionGroup *    browser_perspective_get_actions_group
                                                        (BrowserPerspective *perspective);
const gchar *       browser_perspective_get_actions_ui  (BrowserPerspective *perspective);
void                browser_perspective_get_current_customization
                                                        (BrowserPerspective *perspective,
                                                         GtkActionGroup **out_agroup,
                                                         const gchar **out_ui);
void                browser_perspective_page_tab_label_change
                                                        (BrowserPerspective *perspective,
                                                         BrowserPage *page);

Object Hierarchy

  GInterface
   +----BrowserPerspective

Prerequisites

BrowserPerspective requires GtkWidget.

Known Implementations

BrowserPerspective is implemented by DataManagerPerspective.

Description

BrowserPerspective is an interface used by the BrowserWindow object to switch between the activities ("perspectives"); it requires the GtkWidget.

Details

BROWSER_PERSPECTIVE_TYPE

#define BROWSER_PERSPECTIVE_TYPE            (browser_perspective_get_type())


BROWSER_PERSPECTIVE()

#define BROWSER_PERSPECTIVE(obj)            (G_TYPE_CHECK_INSTANCE_CAST (obj, BROWSER_PERSPECTIVE_TYPE, BrowserPerspective))

obj :


IS_BROWSER_PERSPECTIVE()

#define IS_BROWSER_PERSPECTIVE(obj)         (G_TYPE_CHECK_INSTANCE_TYPE (obj, BROWSER_PERSPECTIVE_TYPE))

obj :


BROWSER_PERSPECTIVE_GET_CLASS()

#define BROWSER_PERSPECTIVE_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_INTERFACE ((obj), BROWSER_PERSPECTIVE_TYPE, BrowserPerspectiveIface))

obj :


BrowserPerspective

typedef struct _BrowserPerspective BrowserPerspective;


browser_perspective_get_type ()

GType               browser_perspective_get_type        (void);

Returns :


browser_perspective_get_actions_group ()

GtkActionGroup *    browser_perspective_get_actions_group
                                                        (BrowserPerspective *perspective);

Get the GtkActionGroup from a pers to represent its specific actions.

perspective :

Returns :

a new GtkActionGroup

browser_perspective_get_actions_ui ()

const gchar *       browser_perspective_get_actions_ui  (BrowserPerspective *perspective);

Get the UI definition from a perspective to represent how its specific actions (obtained using browser_perspective_get_actions_group()) are to be integrated in a BrowserWindow's menu and toolbar.

perspective :

Returns :

a read-only string

browser_perspective_get_current_customization ()

void                browser_perspective_get_current_customization
                                                        (BrowserPerspective *perspective,
                                                         GtkActionGroup **out_agroup,
                                                         const gchar **out_ui);

Rem: *out_agroup is a new object and should be unref'ed when not needed anymore

perspective :

out_agroup :

a place to store the returned GtkActionGroup, not NULL. [transfer full]

out_ui :

a place to store the returned UI string, not NULL. [transfer none]

browser_perspective_page_tab_label_change ()

void                browser_perspective_page_tab_label_change
                                                        (BrowserPerspective *perspective,
                                                         BrowserPage *page);

When pers organizes its contents as pages in a notebook, each page may request that the tab's label may be changed, and the purpose of this method is to request that pers update the tab's label associated to page.

perspective :

page :

an object implementing the BrowserPage interface