Details
enum GladeUtilFileDialogType
typedef enum _GladeUtilFileDialogType
{
GLADE_FILE_DIALOG_ACTION_OPEN,
GLADE_FILE_DIALOG_ACTION_SAVE
} GladeUtilFileDialogType;
enum GladeUIMessageType
typedef enum
{
GLADE_UI_INFO,
GLADE_UI_WARN,
GLADE_UI_ERROR,
GLADE_UI_ARE_YOU_SURE,
GLADE_UI_YES_OR_NO
} GladeUIMessageType;
glade_util_get_type_from_name ()
GType glade_util_get_type_from_name (const gchar *name,
gboolean have_func);
Returns the type using the "get type" function name based on name.
If the have_func flag is true,name is used directly, otherwise the get-type
function is contrived from name then used.
name : |
the name of the GType - like 'GtkWidget' or a "get-type" function.
|
have_func : |
function-name flag -- true if the name is a "get-type" function.
|
| Returns : |
the new GType
|
glade_utils_get_pspec_from_funcname ()
GParamSpec * glade_utils_get_pspec_from_funcname (const gchar *funcname);
funcname : |
the symbol name of a function to generate a GParamSpec
|
| Returns : |
A GParamSpec created by the delagate function
specified by funcname
|
glade_util_ui_message ()
gboolean glade_util_ui_message (GtkWidget *parent,
GladeUIMessageType type,
GtkWidget *widget,
const gchar *format,
...);
Creates a new warning dialog window as a child of parent containing
the text of format, runs it, then destroys it on close. Depending
on type, a cancel button may apear or the icon may change.
parent : |
a GtkWindow cast as a GtkWidget
|
type : |
a GladeUIMessageType
|
widget : |
a GtkWidget to append to the dialog vbox
|
format : |
a printf style format string
|
... : |
args for the format.
|
| Returns : |
True if the type was GLADE_UI_ARE_YOU_SURE and the user
selected "OK", True if the type was GLADE_UI_YES_OR_NO and
the user selected "YES"; False otherwise.
|
glade_util_flash_message ()
void glade_util_flash_message (GtkWidget *statusbar,
guint context_id,
gchar *format,
...);
glade_util_compare_stock_labels ()
gint glade_util_compare_stock_labels (gconstpointer a,
gconstpointer b);
This is a GCompareFunc that compares the labels of two stock items,
ignoring any '_' characters. It isn't particularly efficient.
glade_util_hide_window ()
void glade_util_hide_window (GtkWindow *window);
If you use this function to handle the delete_event of a window, when it
will be shown again it will appear in the position where it was before
beeing hidden.
glade_util_gtk_combo_func ()
gchar * glade_util_gtk_combo_func (gpointer data);
TODO: write me
glade_util_gtk_combo_find ()
gpointer glade_util_gtk_combo_find (GtkCombo *combo);
TODO: write me
glade_util_replace ()
void glade_util_replace (gchar *str,
gchar a,
gchar b);
Replaces each occurance of the character a in str to b.
glade_util_read_prop_name ()
gchar * glade_util_read_prop_name (const gchar *str);
Return a usable version of a property identifier as found
in a freshly parserd GladeInterface
glade_util_duplicate_underscores ()
gchar * glade_util_duplicate_underscores (const gchar *name);
Duplicates name, but the copy has two underscores in place of any single
underscore in the original.
name : |
a string
|
| Returns : |
a newly allocated string
|
glade_util_add_selection ()
void glade_util_add_selection (GtkWidget *widget);
Add visual selection to this GtkWidget
glade_util_remove_selection ()
void glade_util_remove_selection (GtkWidget *widget);
Remove visual selection from this GtkWidget
glade_util_has_selection ()
gboolean glade_util_has_selection (GtkWidget *widget);
widget : |
a GtkWidget
|
| Returns : |
TRUE if widget has visual selection, FALSE otherwise
|
glade_util_clear_selection ()
void glade_util_clear_selection (void);
Clear all visual selections
glade_util_get_selection ()
GList * glade_util_get_selection (void);
glade_util_container_get_all_children ()
GList * glade_util_container_get_all_children
(GtkContainer *container);
Use this to itterate over all children in a GtkContainer,
as it used _forall() instead of _foreach() (and the GTK+ version
of this function is simply not exposed).
Note that glade_widget_class_get_children() is the high-level
abstraction and will usually end up calling this function.
glade_util_count_placeholders ()
gint glade_util_count_placeholders (GladeWidget *parent);
glade_util_basenames_match ()
gboolean glade_util_basenames_match (const gchar *path1,
const gchar *path2);
glade_util_purify_list ()
GList * glade_util_purify_list (GList *list);
list : |
A GList
|
| Returns : |
A newly allocated version of list with no
duplicate data entries
|
glade_util_added_in_list ()
GList * glade_util_added_in_list (GList *old_list,
GList *new_list);
old_list : |
the old GList
|
new_list : |
the new GList
|
| Returns : |
A newly allocated GList of elements that
are in new but not in old
|
glade_util_removed_from_list ()
GList * glade_util_removed_from_list (GList *old_list,
GList *new_list);
old_list : |
the old GList
|
new_list : |
the new GList
|
| Returns : |
A newly allocated GList of elements that
are in old no longer in new
|
glade_util_canonical_path ()
gchar * glade_util_canonical_path (const gchar *path);
path : |
any path that may contain ".." or "." components
|
| Returns : |
an absolute path to the specified file or directory
that contains no ".." or "." components (this does
not call readlink like realpath() does).
Note: on some systems; I think its possible that we dont have
permission to execute in the directory in which the glade
file resides; I decided finally to do it this way anyway
since libc's realpath() does exactly the same.
|
glade_util_copy_file ()
gboolean glade_util_copy_file (const gchar *src_path,
const gchar *dest_path);
Copies a file from src to dest, queries the user
if it involves overwriting the target and displays an
error message upon failure.
src_path : |
the path to the source file
|
dest_path : |
the path to the destination file to create or overwrite.
|
| Returns : |
True if the copy was successfull.
|
glade_util_class_implements_interface ()
gboolean glade_util_class_implements_interface
(GType class_type,
GType iface_type);
class_type : |
A GType
|
iface_type : |
A GType
|
| Returns : |
whether class_type implements the iface_type interface
|
glade_util_load_library ()
GModule * glade_util_load_library (const gchar *library_name);
Loads the named library from the Glade modules directory, or failing that
from the standard platform specific directories.
The library_name should not include any platform specifix prefix or suffix,
those are automatically added, if needed, by g_module_build_path()
library_name : |
name of the library
|
| Returns : |
a GModule on success, or NULL on failure.
|
glade_util_file_is_writeable ()
gboolean glade_util_file_is_writeable (const gchar *path);
Checks whether the file at path is writeable
path : |
the path to the file
|
| Returns : |
TRUE if file is writeable
|
glade_util_have_devhelp ()
gboolean glade_util_have_devhelp (void);
| Returns : |
whether the devhelp module is loaded
|
glade_util_get_devhelp_icon ()
GtkWidget * glade_util_get_devhelp_icon (GtkIconSize size);
Creates an image displaying the devhelp icon.
size : |
the preferred icon size
|
| Returns : |
a GtkImage
|
glade_util_search_devhelp ()
void glade_util_search_devhelp (const gchar *book,
const gchar *page,
const gchar *search);
glade_util_get_placeholder_from_pointer ()
GtkWidget * glade_util_get_placeholder_from_pointer
(GtkContainer *container);
glade_util_object_is_loading ()
gboolean glade_util_object_is_loading (GObject *object);
object : |
A GObject
|
| Returns : |
Whether the object's project is being loaded or not.
|
glade_util_url_show ()
gboolean glade_util_url_show (const gchar *url);
Portable function for showing an URL url in a web browser.
url : |
An URL to display
|
| Returns : |
TRUE if a web browser was successfully launched, or FALSE
|
glade_util_get_file_mtime ()
time_t glade_util_get_file_mtime (const gchar *filename,
GError **error);
Gets the UTC modification time of file filename.
filename : |
A filename
|
error : |
return location for errors
|
| Returns : |
The mtime of the file, or 0 if the file attributes
could not be read.
|
glade_util_draw_selection_nodes ()
void glade_util_draw_selection_nodes (GdkWindow *expose_win);
Redraws any selection nodes that intersect expose_win. Steps through all
selected widgets, finds their coordinates, and calls glade_util_draw_nodes()
if appropriate.