ExoToolbarsEditor: Exo Reference Manual

ExoToolbarsEditor

ExoToolbarsEditor — Widget to edit toolbars

Functions

GtkWidget *	exo_toolbars_editor_new ()
GtkWidget *	exo_toolbars_editor_new_with_model ()
ExoToolbarsModel *	exo_toolbars_editor_get_model ()
void	exo_toolbars_editor_set_model ()
GtkUIManager *	exo_toolbars_editor_get_ui_manager ()
void	exo_toolbars_editor_set_ui_manager ()

Properties

ExoToolbarsModel *	model	Read / Write
GtkUIManager *	ui-manager	Read / Write

Types and Values

struct

ExoToolbarsEditor

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBox
                        ╰── GtkVBox
                            ╰── ExoToolbarsEditor

Implemented Interfaces

ExoToolbarsEditor implements AtkImplementorIface, GtkBuildable and GtkOrientable.

Includes

#include <exo/exo.h>

Description

ExoToolbarsEditor is a widget that allows the user to edit toolbars used within your application by simply dragging and dropping toolbar items between the editor widget and the toolbar widgets.

Most applications should simply use the ExoToolbarsEditorDialog class, which includes an ExoToolbarsEditor as main widget.

Functions

exo_toolbars_editor_new ()

GtkWidget *
exo_toolbars_editor_new (GtkUIManager *ui_manager);

Creates a new ExoToolbarsEditor that will be associated with ui_manager . ui_manager must be a valid GtkUIManager, NULL is not allowed at this point.

The newly created ExoToolbarsEditor will not be usable until you associate an ExoToolbarsModel with it, using the function exo_toolbars_editor_set_model(). You should probably use exo_toolbars_editor_new_with_model() instead.

Parameters

ui_manager

A GtkUIManager.

Returns

A new ExoToolbarsEditor.

exo_toolbars_editor_new_with_model ()

GtkWidget *
exo_toolbars_editor_new_with_model (GtkUIManager *ui_manager,
                                    ExoToolbarsModel *model);

Creates a new ExoToolbarsEditor that will be associated with model and ui_manager . You must supply a valid GtkUIManager and a valid ExoToolbarsModel here or the function will fail.

Parameters

ui_manager	A GtkUIManager.
model	An ExoToolbarsModel.

Returns

A new ExoToolbarsEditor.

exo_toolbars_editor_get_model ()

ExoToolbarsModel *
exo_toolbars_editor_get_model (ExoToolbarsEditor *editor);

Returns the ExoToolbarsModel currently associated with editor or NULL if no ExoToolbarsModel is currently associated with editor .

Parameters

editor

An ExoToolbarsEditor.

Returns

An ExoToolbarsModel or NULL.

exo_toolbars_editor_set_model ()

void
exo_toolbars_editor_set_model (ExoToolbarsEditor *editor,
                               ExoToolbarsModel *model);

Sets the model to edit by this editor . If you specify NULL for model , the editor widget will be disabled. Else the editor widget will load the toolbars from model and reinitialize its user interface according to model .

Parameters

editor	An ExoToolbarsEditor.
model	An ExoToolbarsModel or `NULL`.

exo_toolbars_editor_get_ui_manager ()

GtkUIManager *
exo_toolbars_editor_get_ui_manager (ExoToolbarsEditor *editor);

Returns the GtkUIManager associated with editor or NULL if no user interface manager is associated with editor currently.

Parameters

editor

An ExoToolbarsEditor.

Returns

A GtkUIManager or NULL.

exo_toolbars_editor_set_ui_manager ()

void
exo_toolbars_editor_set_ui_manager (ExoToolbarsEditor *editor,
                                    GtkUIManager *ui_manager);

Sets the GtkUIManager to use by this ExoToolbarsEditor. If you specify NULL for ui_manager , the editor widget will be disabled. Else the editor will load the available actions from ui_manager and reinitialize the user interface.

Parameters

editor	An ExoToolbarsEditor.
ui_manager	A GtkUIManager or `NULL`.

Types and Values

struct ExoToolbarsEditor

struct ExoToolbarsEditor;

The ExoToolbarsEditor struct contains only private fields and should not be directly accessed.

Property Details

The `“model”` property

  “model”                    ExoToolbarsModel *

The ExoToolbarsModel that should be edited from within this toolbars editor. If you set this property to NULL, the editor widget will be disabled, else the editor widget will load the toolbars from the given ExoToolbarsModel and initialize its user interface according to the model.

Flags: Read / Write

The `“ui-manager”` property

  “ui-manager”               GtkUIManager *

The GtkUIManager used by this editor. If this property is NULL, the editor widget will be disabled, else if you specify a valid GtkUIManager, the editor widget will load the available actions from the given user interface manager and initialize its user interface according to the specified GtkUIManager.

The given ui -manager needs to support all actions that were specified for the model, used by the editor, with the exo_toolbars_model_set_actions() method.

Flags: Read / Write