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, QueryExecPerspective and SchemaBrowserPerspective.

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))


IS_BROWSER_PERSPECTIVE()

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


BROWSER_PERSPECTIVE_GET_CLASS()

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


BrowserPerspective

typedef struct _BrowserPerspective BrowserPerspective;


browser_perspective_get_type ()

GType               browser_perspective_get_type        (void);


browser_perspective_get_actions_group ()

GtkActionGroup *    browser_perspective_get_actions_group
                                                        (BrowserPerspective *perspective);

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

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.

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

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.

page :

an object implementing the BrowserPage interface