Top | ![]() |
![]() |
![]() |
![]() |
void | add-widget | Run Last |
void | changed | Run First |
void | close | Run Last |
void | convert-finished | Run First |
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 |
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.
void glade_project_set_format (GladeProject *project
,GladeProjectFormat format
);
Sets project
format to format
, used internally to set the actual format
state; note that conversions should be done through the glade-command api.
gboolean glade_project_load_from_file (GladeProject *project
,const gchar *path
);
GladeProject *
glade_project_load (const gchar *path
);
Opens a project at the given path.
gboolean glade_project_save (GladeProject *project
,const gchar *path
,GError **error
);
Saves project
to the given path.
void
glade_project_undo (GladeProject *project
);
Redoes a GladeCommand in this project.
GladeCommand *
glade_project_next_undo_item (GladeProject *project
);
Gets the next undo item on project
's command stack.
GladeCommand *
glade_project_next_redo_item (GladeProject *project
);
Gets the next redo item on project
's command stack.
void glade_project_push_undo (GladeProject *project
,GladeCommand *cmd
);
Pushes a newly created GladeCommand onto projects
stack.
GtkWidget *
glade_project_undo_items (GladeProject *project
);
Creates a menu of the undo items in the project stack
GtkWidget *
glade_project_redo_items (GladeProject *project
);
Creates a menu of the undo items in the project stack
gboolean
glade_project_get_readonly (GladeProject *project
);
Gets whether the project is read only or not
void glade_project_add_object (GladeProject *project
,GladeProject *old_project
,GObject *object
);
Adds an object to the project.
project |
the GladeProject the widget is added to |
|
old_project |
the GladeProject the widget was previously in
(or |
|
object |
the GObject to add |
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.
gboolean glade_project_has_object (GladeProject *project
,GObject *object
);
GladeWidget * glade_project_get_widget_by_name (GladeProject *project
,GladeWidget *ancestor
,const gchar *name
);
Searches under ancestor
in project
looking for a GladeWidget named 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
.
project |
||
widget |
the GladeWidget intended to recieve a new name |
|
base_name |
base name of the widget to create |
gboolean glade_project_is_selected (GladeProject *project
,GObject *object
);
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()
.
project |
||
object |
a GObject in |
|
emit_signal |
whether or not to emit a signal indicating a selection change |
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()
.
project |
||
object |
a GObject in |
|
emit_signal |
whether or not to emit a signal indicating a selection change |
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()
.
project |
||
object |
a GObject in |
|
emit_signal |
whether or not to emit a signal indicating a selection change |
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()
.
void
glade_project_selection_changed (GladeProject *project
);
Causes project
to emit a "selection_changed" signal.
gboolean
glade_project_get_has_selection (GladeProject *project
);
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.
gboolean
glade_project_get_modified (GladeProject *project
);
Get's whether the project has been modified since it was last saved.
“format”
property“format” gint
The project file format.
Flags: Read
Allowed values: [0,1]
Default value: 1
“has-selection”
property“has-selection” gboolean
Whether project has a selection.
Flags: Read
Default value: FALSE
“modified”
property“modified” gboolean
Whether project has been modified since it was last saved.
Flags: Read
Default value: FALSE
“path”
property“path” gchar *
The filesystem path of the project.
Flags: Read
Default value: NULL
“read-only”
property“read-only” gboolean
Whether project is read-only.
Flags: Read
Default value: FALSE
“add-widget”
signalvoid user_function (GladeProject *gladeproject, GladeWidget *arg1, gpointer user_data)
Emitted when a widget is added to a project.
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
“changed”
signalvoid user_function (GladeProject *gladeproject, GladeCommand *arg1, gboolean arg2, gpointer user_data)
Emitted when a gladeproject
's state changes via a GladeCommand.
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
“close”
signalvoid user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when a project is closing (a good time to clean up any associated resources).
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“convert-finished”
signalvoid user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when gladeproject
format conversion has finished.
NOTE: Some properties are internally handled differently when the project is in a said format, this signal is fired after the new format is in effect to allow the backend access to both before and after.
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“load-progress”
signalvoid user_function (GladeProject *gladeproject, gint objects_total, gint objects_loaded, gpointer user_data)
Emitted while project
is loading.
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
“parse-began”
signalvoid user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when gladeproject
parsing starts.
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“parse-finished”
signalvoid user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when gladeproject
parsing has finished.
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“remove-widget”
signalvoid user_function (GladeProject *gladeproject, GladeWidget *arg1, gpointer user_data)
Emitted when a widget is removed from a project.
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
“selection-changed”
signalvoid user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when gladeproject
selection list changes.
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“targets-changed”
signalvoid user_function (GladeProject *gladeproject, gpointer user_data)
Emitted when gladeproject
target versions change.
gladeproject |
the GladeProject which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“widget-name-changed”
signalvoid user_function (GladeProject *gladeproject, GladeWidget *arg1, gpointer user_data)
Emitted when gwidget
's name changes.
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