| Top |
Functions
Properties
| GladeWidgetAdaptor * | add-item | Read |
| gchar * | css-provider-path | Read / Write |
| gboolean | has-selection | Read |
| gchar * | license | Read / Write |
| gboolean | modified | Read |
| gchar * | path | Read |
| GladePointerMode | pointer-mode | Read |
| gboolean | read-only | Read |
| gchar * | resource-path | Read / Write |
| GladeWidget * | template | Read / Write |
| gchar * | translation-domain | Read / Write |
Signals
| void | add-widget | Run Last |
| void | changed | Run First |
| void | close | Run Last |
| void | load-progress | Run First |
| void | parse-began | Run First |
| void | parse-finished | Run First |
| void | remove-widget | Run Last |
| void | selection-changed | Run Last |
| void | targets-changed | Run First |
| void | widget-name-changed | Run Last |
| void | widget-visibility-changed | Run First |
Description
This object owns all project objects and is responsable for loading and saving the glade document, you can monitor the project state via this object and its signals.
Functions
glade_project_load_from_file ()
gboolean glade_project_load_from_file (GladeProject *project,const gchar *path);
glade_project_load ()
GladeProject *
glade_project_load (const gchar *path);
Opens a project at the given path.
glade_project_save ()
gboolean glade_project_save (GladeProject *project,const gchar *path,GError **error);
Saves project
to the given path.
glade_project_undo ()
void
glade_project_undo (GladeProject *project);
Redoes a GladeCommand in this project.
glade_project_next_undo_item ()
GladeCommand *
glade_project_next_undo_item (GladeProject *project);
Gets the next undo item on project
's command stack.
glade_project_next_redo_item ()
GladeCommand *
glade_project_next_redo_item (GladeProject *project);
Gets the next redo item on project
's command stack.
glade_project_push_undo ()
void glade_project_push_undo (GladeProject *project,GladeCommand *cmd);
Pushes a newly created GladeCommand onto projects
stack.
glade_project_undo_items ()
GtkWidget *
glade_project_undo_items (GladeProject *project);
Creates a menu of the undo items in the project stack
glade_project_redo_items ()
GtkWidget *
glade_project_redo_items (GladeProject *project);
Creates a menu of the undo items in the project stack
glade_project_get_readonly ()
gboolean
glade_project_get_readonly (GladeProject *project);
Gets whether the project is read only or not
glade_project_add_object ()
void glade_project_add_object (GladeProject *project,GObject *object);
Adds an object to the project.
glade_project_remove_object ()
void glade_project_remove_object (GladeProject *project,GObject *object);
Removes object
from project
.
Note that when removing the GObject from the project we don't change ->project in the associated GladeWidget; this way UNDO can work.
glade_project_has_object ()
gboolean glade_project_has_object (GladeProject *project,GObject *object);
glade_project_get_widget_by_name ()
GladeWidget * glade_project_get_widget_by_name (GladeProject *project,const gchar *name);
Searches under ancestor
in project
looking for a GladeWidget named name
.
glade_project_new_widget_name ()
gchar * glade_project_new_widget_name (GladeProject *project,GladeWidget *widget,const gchar *base_name);
Creates a new name for a widget that doesn't collide with any of the names
already in project
. This name will start with base_name
.
Note the widget
parameter is ignored and preserved only for historical reasons.
Parameters
project |
||
widget |
the GladeWidget intended to recieve a new name, or |
|
base_name |
base name of the widget to create |
glade_project_is_selected ()
gboolean glade_project_is_selected (GladeProject *project,GObject *object);
glade_project_selection_set ()
void glade_project_selection_set (GladeProject *project,GObject *object,gboolean emit_signal);
Set the selection in project
to object
If emit_signal
is TRUE, calls glade_project_selection_changed().
glade_project_selection_add ()
void glade_project_selection_add (GladeProject *project,GObject *object,gboolean emit_signal);
Adds object
to the selection chain of project
If emit_signal
is TRUE, calls glade_project_selection_changed().
glade_project_selection_remove ()
void glade_project_selection_remove (GladeProject *project,GObject *object,gboolean emit_signal);
Removes object
from the selection chain of project
If emit_signal
is TRUE, calls glade_project_selection_changed().
glade_project_selection_clear ()
void glade_project_selection_clear (GladeProject *project,gboolean emit_signal);
Clears project
's selection chain
If emit_signal
is TRUE, calls glade_project_selection_changed().
glade_project_selection_changed ()
void
glade_project_selection_changed (GladeProject *project);
Causes project
to emit a "selection_changed" signal.
glade_project_get_has_selection ()
gboolean
glade_project_get_has_selection (GladeProject *project);
glade_project_resource_fullpath ()
gchar * glade_project_resource_fullpath (GladeProject *project,const gchar *resource);
Project resource strings may be relative or fullpaths, but glade always expects a copy in the glade file directory, this function is used to make a local path to the file.
glade_project_get_modified ()
gboolean
glade_project_get_modified (GladeProject *project);
Get's whether the project has been modified since it was last saved.
Property Details
The “add-item” property
“add-item” GladeWidgetAdaptor *
The current item to add to the project.
Flags: Read
The “css-provider-path” property
“css-provider-path” gchar *
Path to use as the custom CSS provider for this project.
Flags: Read / Write
Default value: NULL
The “has-selection” property
“has-selection” gboolean
Whether project has a selection.
Flags: Read
Default value: FALSE
The “license” property
“license” gchar *
License for this project, it will be added as a document level comment.
Flags: Read / Write
Default value: NULL
The “modified” property
“modified” gboolean
Whether project has been modified since it was last saved.
Flags: Read
Default value: FALSE
The “path” property
“path” gchar *
The filesystem path of the project.
Flags: Read
Default value: NULL
The “pointer-mode” property
“pointer-mode” GladePointerMode
The currently effective GladePointerMode.
Flags: Read
Default value: GLADE_POINTER_SELECT
The “read-only” property
“read-only” gboolean
Whether project is read-only.
Flags: Read
Default value: FALSE
The “resource-path” property
“resource-path” gchar *
Path to load images and resources in Glade's runtime.
Flags: Read / Write
Default value: NULL
The “template” property
“template” GladeWidget *
The project's template widget, if any.
Flags: Read / Write
Signal Details
The “add-widget” signal
void user_function (GladeProject *gladeproject, GladeWidget *arg1, gpointer user_data)
Emitted when a widget is added to a project.
Parameters
gladeproject |
the GladeProject which received the signal. |
|
arg1 |
the GladeWidget that was added to |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “changed” signal
void user_function (GladeProject *gladeproject, GladeCommand *arg1, gboolean arg2, gpointer user_data)
Emitted when a gladeproject
's state changes via a GladeCommand.
Parameters
gladeproject |
the GladeProject which received the signal. |
|
arg1 |
the GladeCommand that was executed |
|
arg2 |
whether the command was executed or undone. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
The “close” signal
void user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when a project is closing (a good time to clean up any associated resources).
Parameters
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “load-progress” signal
void user_function (GladeProject *gladeproject, gint objects_total, gint objects_loaded, gpointer user_data)
Emitted while project
is loading.
Parameters
gladeproject |
the GladeProject which received the signal. |
|
objects_total |
the total amount of objects to load |
|
objects_loaded |
the current amount of loaded objects |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
The “parse-began” signal
void user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when gladeproject
parsing starts.
Parameters
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
The “parse-finished” signal
void user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when gladeproject
parsing has finished.
Parameters
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
The “remove-widget” signal
void user_function (GladeProject *gladeproject, GladeWidget *arg1, gpointer user_data)
Emitted when a widget is removed from a project.
Parameters
gladeproject |
the GladeProject which received the signal. |
|
arg1 |
the GladeWidget that was removed from |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “selection-changed” signal
void user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when gladeproject
selection list changes.
Parameters
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “targets-changed” signal
void user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when gladeproject
target versions change.
Parameters
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
The “widget-name-changed” signal
void user_function (GladeProject *gladeproject, GladeWidget *arg1, gpointer user_data)
Emitted when gwidget
's name changes.
Parameters
gladeproject |
the GladeProject which received the signal. |
|
arg1 |
the GladeWidget who's name changed. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “widget-visibility-changed” signal
void user_function (GladeProject *gladeproject, GladeWidget *widget, gboolean visible, gpointer user_data)
Emitted when the visivility of a widget changed
Parameters
gladeproject |
the GladeProject which received the signal. |
|
widget |
the widget that its visibity changed |
|
visible |
the current visiblity of the widget |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
