![]() |
![]() |
![]() |
Glade UI Builder Reference Manual | ![]() |
---|---|---|---|---|
GladeProjectPrivate; struct GladeProject; GladeProject* glade_project_new (void); gboolean glade_project_load_from_file (GladeProject *project, const gchar *path); GladeProject* glade_project_load (const gchar *path); gboolean glade_project_save (GladeProject *project, const gchar *path, GError **error); const gchar* glade_project_get_path (GladeProject *project); gchar* glade_project_get_name (GladeProject *project); void glade_project_undo (GladeProject *project); void glade_project_redo (GladeProject *project); GladeCommand* glade_project_next_undo_item (GladeProject *project); GladeCommand* glade_project_next_redo_item (GladeProject *project); void glade_project_push_undo (GladeProject *project, GladeCommand *cmd); GtkWidget* glade_project_undo_items (GladeProject *project); GtkWidget* glade_project_redo_items (GladeProject *project); void glade_project_reset_path (GladeProject *project); gboolean glade_project_get_readonly (GladeProject *project); const GList* glade_project_get_objects (GladeProject *project); void glade_project_add_object (GladeProject *project, GladeProject *old_project, GObject *object); void glade_project_remove_object (GladeProject *project, GObject *object); gboolean glade_project_has_object (GladeProject *project, GObject *object); GladeWidget* glade_project_get_widget_by_name (GladeProject *project, const char *name); char* glade_project_new_widget_name (GladeProject *project, const char *base_name); void glade_project_widget_name_changed (GladeProject *project, GladeWidget *widget, const char *old_name); gboolean glade_project_is_selected (GladeProject *project, GObject *object); void glade_project_selection_set (GladeProject *project, GObject *object, gboolean emit_signal); void glade_project_selection_add (GladeProject *project, GObject *object, gboolean emit_signal); void glade_project_selection_remove (GladeProject *project, GObject *object, gboolean emit_signal); void glade_project_selection_clear (GladeProject *project, gboolean emit_signal); void glade_project_selection_changed (GladeProject *project); GList* glade_project_selection_get (GladeProject *project); gboolean glade_project_get_has_selection (GladeProject *project); void glade_project_set_accel_group (GladeProject *project, GtkAccelGroup *accel_group); void glade_project_set_resource (GladeProject *project, GladeProperty *property, const gchar *resource); GList* glade_project_list_resources (GladeProject *project); gchar* glade_project_resource_fullpath (GladeProject *project, const gchar *resource); gboolean glade_project_is_loading (GladeProject *project); time_t glade_project_get_file_mtime (GladeProject *project); guint glade_project_get_instance_count (GladeProject *project); void glade_project_set_instance_count (GladeProject *project, guint instance_count); gboolean glade_project_get_modified (GladeProject *project);
"has-selection" gboolean : Read "modified" gboolean : Read "path" gchar* : Read "read-only" gboolean : Read
"add-widget" : Run Last "changed" : Run First "close" : Run Last "parse-finished" : Run First "remove-widget" : Run Last "resource-added" : Run Last "resource-removed" : Run Last "selection-changed" : Run Last "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.
GladeProject* glade_project_new (void);
Creates a new GladeProject.
Returns : |
a new GladeProject |
gboolean glade_project_load_from_file (GladeProject *project, const gchar *path);
|
|
|
|
Returns : |
GladeProject* glade_project_load (const gchar *path);
Opens a project at the given path.
|
|
Returns : |
a new GladeProject for the opened project on success, NULL on
failure
|
gboolean glade_project_save (GladeProject *project, const gchar *path, GError **error);
Saves project
to the given path.
|
a GladeProject |
|
location to save glade file |
|
an error from the G_FILE_ERROR domain. |
Returns : |
TRUE on success, FALSE on failure
|
const gchar* glade_project_get_path (GladeProject *project);
|
|
Returns : |
gchar* glade_project_get_name (GladeProject *project);
|
|
Returns : |
void glade_project_undo (GladeProject *project);
Redoes a GladeCommand in this project.
|
a GladeProject |
GladeCommand* glade_project_next_undo_item (GladeProject *project);
Gets the next undo item on project
's command stack.
|
a GladeProject |
Returns : |
the GladeCommand |
GladeCommand* glade_project_next_redo_item (GladeProject *project);
Gets the next redo item on project
's command stack.
|
a GladeProject |
Returns : |
the GladeCommand |
void glade_project_push_undo (GladeProject *project, GladeCommand *cmd);
Pushes a newly created GladeCommand onto projects
stack.
|
a GladeProject |
|
the GladeCommand |
GtkWidget* glade_project_undo_items (GladeProject *project);
Creates a menu of the undo items in the project stack
|
A GladeProject |
Returns : |
A newly created menu |
GtkWidget* glade_project_redo_items (GladeProject *project);
Creates a menu of the undo items in the project stack
|
A GladeProject |
Returns : |
A newly created menu |
gboolean glade_project_get_readonly (GladeProject *project);
Gets whether the project is read only or not
|
a GladeProject |
Returns : |
TRUE if project is read only |
const GList* glade_project_get_objects (GladeProject *project);
|
|
Returns : |
void glade_project_add_object (GladeProject *project, GladeProject *old_project, GObject *object);
Adds an object to the project.
|
the GladeProject the widget is added to |
|
the GladeProject the widget was previously in
(or NULL for the clipboard)
|
|
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.
|
a GladeProject |
|
the GObject to remove |
gboolean glade_project_has_object (GladeProject *project, GObject *object);
|
the GladeProject the widget is added to |
|
the GObject to search |
Returns : |
whether this object is in this project. |
GladeWidget* glade_project_get_widget_by_name (GladeProject *project, const char *name);
Searches through project
looking for a GladeWidget named name
.
|
a GladeProject |
|
The user visible name of the widget we are looking for |
Returns : |
a pointer to the widget, NULL if the widget does not exist
|
char* glade_project_new_widget_name (GladeProject *project, const char *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
.
|
a GladeProject |
|
base name of the widget to create |
Returns : |
a string containing the new name, NULL if there is not enough
memory for this string
|
void glade_project_widget_name_changed (GladeProject *project, GladeWidget *widget, const char *old_name);
TODO: write me
|
a GladeProject |
|
a GladeWidget |
|
gboolean glade_project_is_selected (GladeProject *project, GObject *object);
|
a GladeProject |
|
a GObject |
Returns : |
whether object is in project selection
|
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()
.
|
a GladeProject |
|
a GObject in project
|
|
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()
.
|
a GladeProject |
|
a GObject in project
|
|
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()
.
|
a GladeProject |
|
a GObject in project
|
|
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()
.
|
a GladeProject |
|
whether or not to emit a signal indication a selection change |
void glade_project_selection_changed (GladeProject *project);
Causes project
to emit a "selection_changed" signal.
|
a GladeProject |
GList* glade_project_selection_get (GladeProject *project);
|
a GladeProject |
Returns : |
a GList containing the GtkWidget items currently selected in
project
|
gboolean glade_project_get_has_selection (GladeProject *project);
|
a GladeProject |
Returns : |
whether project currently has a selection
|
void glade_project_set_accel_group (GladeProject *project, GtkAccelGroup *accel_group);
Set accel_group
to every top level widget in project
.
|
A GladeProject |
|
The GtkAccelGroup
|
void glade_project_set_resource (GladeProject *project, GladeProperty *property, const gchar *resource);
Adds/Modifies/Removes a resource from a project; any project resources will be copied when using "Save As...", when moving widgets across projects and will be copied into the project's directory when selected.
|
A GladeProject |
|
The GladeProperty this resource is required by |
|
The resource file basename to be found in the same directory as the glade file. |
GList* glade_project_list_resources (GladeProject *project);
|
A GladeProject |
Returns : |
A newly allocated GList of file basenames of resources in this project, note that the strings are not allocated and are unsafe to use once the projects state changes. The returned list should be freed with g_list_free. |
gchar* glade_project_resource_fullpath (GladeProject *project, const gchar *resource);
|
The GladeProject. |
|
The resource basename |
Returns : |
A newly allocated string holding the full path the the project resource. |
gboolean glade_project_is_loading (GladeProject *project);
|
A GladeProject |
Returns : |
Whether the project is being loaded or not |
time_t glade_project_get_file_mtime (GladeProject *project);
|
|
Returns : |
guint glade_project_get_instance_count (GladeProject *project);
|
|
Returns : |
void glade_project_set_instance_count (GladeProject *project, guint instance_count);
|
|
|
gboolean glade_project_get_modified (GladeProject *project);
Get's whether the project has been modified since it was last saved.
|
a GladeProject |
Returns : |
TRUE if the project has been modified since it was last saved |
"has-selection"
property"has-selection" gboolean : Read
Whether project has a selection.
Default value: FALSE
"modified"
property"modified" gboolean : Read
Whether project has been modified since it was last saved.
Default value: FALSE
"add-widget"
signalvoid user_function (GladeProject *gladeproject, GladeWidget *arg1, gpointer user_data) : Run Last
Emitted when a widget is added to a project.
|
the GladeProject which received the signal. |
|
the GladeWidget that was added to gladeproject .
|
|
user data set when the signal handler was connected. |
"changed"
signalvoid user_function (GladeProject *gladeproject, GladeCommand *arg1, gboolean arg2, gpointer user_data) : Run First
Emitted when a gladeproject
's state changes via a GladeCommand.
|
the GladeProject which received the signal. |
|
the GladeCommand that was executed |
|
whether the command was executed or undone. |
|
user data set when the signal handler was connected. |
"close"
signalvoid user_function (GladeProject *gladeproject, gpointer user_data) : Run Last
Emitted when a project is closing (a good time to clean up any associated resources).
|
the GladeProject which received the signal. |
|
user data set when the signal handler was connected. |
"parse-finished"
signalvoid user_function (GladeProject *gladeproject, gpointer user_data) : Run First
Emitted when gladeproject
parsing has finished.
|
the GladeProject which received the signal. |
|
user data set when the signal handler was connected. |
"remove-widget"
signalvoid user_function (GladeProject *gladeproject, GladeWidget *arg1, gpointer user_data) : Run Last
Emitted when a widget is removed from a project.
|
the GladeProject which received the signal. |
|
the GladeWidget that was removed from gladeproject .
|
|
user data set when the signal handler was connected. |
"resource-added"
signalvoid user_function (GladeProject *gladeproject, gchar *arg1, gpointer user_data) : Run Last
Emitted when a resource file required by a GladeProperty is
added to gladeproject
|
the GladeProject which received the signal. |
|
the file's basename (in the project path). |
|
user data set when the signal handler was connected. |
"resource-removed"
signalvoid user_function (GladeProject *gladeproject, gchar *arg1, gpointer user_data) : Run Last
Emitted when a resource file is removed from gladeproject
|
the GladeProject which received the signal. |
|
the file's basename |
|
user data set when the signal handler was connected. |
"selection-changed"
signalvoid user_function (GladeProject *gladeproject, gpointer user_data) : Run Last
Emitted when gladeproject
selection list changes.
|
the GladeProject which received the signal. |
|
user data set when the signal handler was connected. |
"widget-name-changed"
signalvoid user_function (GladeProject *gladeproject, GladeWidget *arg1, gpointer user_data) : Run Last
Emitted when gwidget
's name changes.
|
the GladeProject which received the signal. |
|
the GladeWidget who's name changed. |
|
user data set when the signal handler was connected. |