gedit-utils

gedit-utils

Synopsis

#define             GBOOLEAN_TO_POINTER                 (i)
#define             GPOINTER_TO_BOOLEAN                 (i)
#define             IS_VALID_BOOLEAN                    (v)
void                gedit_utils_menu_position_under_widget
                                                        (GtkMenu *menu,
                                                         gint *x,
                                                         gint *y,
                                                         gboolean *push_in,
                                                         gpointer user_data);
void                gedit_utils_menu_position_under_tree_view
                                                        (GtkMenu *menu,
                                                         gint *x,
                                                         gint *y,
                                                         gboolean *push_in,
                                                         gpointer user_data);
gchar *             gedit_utils_escape_underscores      (const gchar *text,
                                                         gssize length);
gchar *             gedit_utils_str_middle_truncate     (const gchar *string,
                                                         guint truncate_length);
void                gedit_utils_set_atk_name_description
                                                        (GtkWidget *widget,
                                                         const gchar *name,
                                                         const gchar *description);
void                gedit_utils_set_atk_relation        (GtkWidget *obj1,
                                                         GtkWidget *obj2,
                                                         AtkRelationType rel_type);
void                gedit_warning                       (GtkWindow *parent,
                                                         const gchar *format,
                                                         ...);
gchar *             gedit_utils_make_valid_utf8         (const char *name);
gchar *             gedit_utils_uri_get_dirname         (const char *uri);
gchar *             gedit_utils_replace_home_dir_with_tilde
                                                        (const gchar *uri);
guint               gedit_utils_get_current_workspace   (GdkScreen *screen);
guint               gedit_utils_get_window_workspace    (GtkWindow *gtkwindow);
gchar *             gedit_utils_make_canonical_uri_from_shell_arg
                                                        (const gchar *str);
gchar *             gedit_utils_basename_for_display    (GFile *location);
gboolean            gedit_utils_decode_uri              (const gchar *uri,
                                                         gchar **scheme,
                                                         gchar **user,
                                                         gchar **port,
                                                         gchar **host,
                                                         gchar **path);
gchar **            gedit_utils_drop_get_uris           (GtkSelectionData *selection_data);
GeditDocumentCompressionType gedit_utils_get_compression_type_from_content_type
                                                        (const gchar *content_type);
void                gedit_utils_get_current_viewport    (GdkScreen *screen,
                                                         gint *x,
                                                         gint *y);
gboolean            gedit_utils_get_ui_objects          (const gchar *filename,
                                                         gchar **root_objects,
                                                         GtkWidget **error_widget,
                                                         const gchar *object_name,
                                                         ...);
gboolean            gedit_utils_get_ui_objects_with_translation_domain
                                                        (const gchar *filename,
                                                         const gchar *translation_domain,
                                                         gchar **root_objects,
                                                         GtkWidget **error_widget,
                                                         const gchar *object_name,
                                                         ...);
gboolean            gedit_utils_is_valid_location       (GFile *location);
gchar *             gedit_utils_location_get_dirname_for_display
                                                        (GFile *location);
gchar *             gedit_utils_set_direct_save_filename
                                                        (GdkDragContext *context);
gchar *             gedit_utils_str_end_truncate        (const gchar *string,
                                                         guint truncate_length);

Description

Details

GBOOLEAN_TO_POINTER()

#define GBOOLEAN_TO_POINTER(i) (GINT_TO_POINTER ((i) ? 2 : 1))

GPOINTER_TO_BOOLEAN()

#define GPOINTER_TO_BOOLEAN(i) ((gboolean) ((GPOINTER_TO_INT(i) == 2) ? TRUE : FALSE))

IS_VALID_BOOLEAN()

#define IS_VALID_BOOLEAN(v) (((v == TRUE) || (v == FALSE)) ? TRUE : FALSE)

gedit_utils_menu_position_under_widget ()

void                gedit_utils_menu_position_under_widget
                                                        (GtkMenu *menu,
                                                         gint *x,
                                                         gint *y,
                                                         gboolean *push_in,
                                                         gpointer user_data);

gedit_utils_menu_position_under_tree_view ()

void                gedit_utils_menu_position_under_tree_view
                                                        (GtkMenu *menu,
                                                         gint *x,
                                                         gint *y,
                                                         gboolean *push_in,
                                                         gpointer user_data);

gedit_utils_escape_underscores ()

gchar *             gedit_utils_escape_underscores      (const gchar *text,
                                                         gssize length);

gedit_utils_str_middle_truncate ()

gchar *             gedit_utils_str_middle_truncate     (const gchar *string,
                                                         guint truncate_length);

gedit_utils_set_atk_name_description ()

void                gedit_utils_set_atk_name_description
                                                        (GtkWidget *widget,
                                                         const gchar *name,
                                                         const gchar *description);

This function sets up name and description for a specified gtk widget.

widget :

The Gtk widget for which name/description to be set

name :

Atk name string

description :

Atk description string

gedit_utils_set_atk_relation ()

void                gedit_utils_set_atk_relation        (GtkWidget *obj1,
                                                         GtkWidget *obj2,
                                                         AtkRelationType rel_type);

gedit_warning ()

void                gedit_warning                       (GtkWindow *parent,
                                                         const gchar *format,
                                                         ...);

gedit_utils_make_valid_utf8 ()

gchar *             gedit_utils_make_valid_utf8         (const char *name);

gedit_utils_uri_get_dirname ()

gchar *             gedit_utils_uri_get_dirname         (const char *uri);

Note: this function replace home dir with ~

uri :

the URI.

Returns :

the directory name.

gedit_utils_replace_home_dir_with_tilde ()

gchar *             gedit_utils_replace_home_dir_with_tilde
                                                        (const gchar *uri);

gedit_utils_get_current_workspace ()

guint               gedit_utils_get_current_workspace   (GdkScreen *screen);

Get the currently visible workspace for the GdkScreen.

If the X11 window property isn't found, 0 (the first workspace) is returned.

screen :

a GdkScreen

gedit_utils_get_window_workspace ()

guint               gedit_utils_get_window_workspace    (GtkWindow *gtkwindow);

Get the workspace the window is on.

This function gets the workspace that the GtkWindow is visible on, it returns GEDIT_ALL_WORKSPACES if the window is sticky, or if the window manager doesn't support this function.

gtkwindow :

a GtkWindow.

Returns :

the workspace the window is on.

gedit_utils_make_canonical_uri_from_shell_arg ()

gchar *             gedit_utils_make_canonical_uri_from_shell_arg
                                                        (const gchar *str);

gedit_utils_basename_for_display ()

gchar *             gedit_utils_basename_for_display    (GFile *location);

location :

location for which the basename should be displayed

Returns :

the basename of a file suitable for display to users. [transfer full]

gedit_utils_decode_uri ()

gboolean            gedit_utils_decode_uri              (const gchar *uri,
                                                         gchar **scheme,
                                                         gchar **user,
                                                         gchar **port,
                                                         gchar **host,
                                                         gchar **path);

Parse and break an uri apart in its individual components like the uri scheme, user info, port, host and path. The return value pointer can be NULL to ignore certain parts of the uri. If the function returns TRUE, then all return value pointers should be freed using g_free

uri :

the uri to decode

scheme :

return value pointer for the uri's scheme (e.g. http, sftp, ...), or NULL. [out][allow-none]

user :

return value pointer for the uri user info, or NULL. [out][allow-none]

port :

return value pointer for the uri port, or NULL. [out][allow-none]

host :

return value pointer for the uri host, or NULL. [out][allow-none]

path :

return value pointer for the uri path, or NULL. [out][allow-none]

Returns :

TRUE if the uri could be properly decoded, FALSE otherwise.

gedit_utils_drop_get_uris ()

gchar **            gedit_utils_drop_get_uris           (GtkSelectionData *selection_data);

Create a list of valid uri's from a uri-list drop.

selection_data :

the GtkSelectionData from drag_data_received

Returns :

a string array which will hold the uris or NULL if there were no valid uris. g_strfreev should be used when the string array is no longer used. [transfer full]

gedit_utils_get_compression_type_from_content_type ()

GeditDocumentCompressionType gedit_utils_get_compression_type_from_content_type
                                                        (const gchar *content_type);

gedit_utils_get_current_viewport ()

void                gedit_utils_get_current_viewport    (GdkScreen *screen,
                                                         gint *x,
                                                         gint *y);

Get the currently visible viewport origin for the GdkScreen.

If the X11 window property isn't found, (0, 0) is returned.

screen :

a GdkScreen

x :

x-axis point. [out]

y :

y-axis point. [out]

gedit_utils_get_ui_objects ()

gboolean            gedit_utils_get_ui_objects          (const gchar *filename,
                                                         gchar **root_objects,
                                                         GtkWidget **error_widget,
                                                         const gchar *object_name,
                                                         ...);

This function gets the requested objects from a GtkBuilder ui file. In case of error it returns FALSE and sets error_widget to a GtkLabel containing the error message to display.

filename :

the path to the gtk builder file

root_objects :

a NULL terminated list of root objects to load or NULL to load all objects

error_widget :

a pointer were a GtkLabel

object_name :

the name of the first object

... :

a pointer were the first object is returned, followed by more name / object pairs and terminated by NULL.

Returns :

FALSE if an error occurs, TRUE on success.

gedit_utils_get_ui_objects_with_translation_domain ()

gboolean            gedit_utils_get_ui_objects_with_translation_domain
                                                        (const gchar *filename,
                                                         const gchar *translation_domain,
                                                         gchar **root_objects,
                                                         GtkWidget **error_widget,
                                                         const gchar *object_name,
                                                         ...);

This function gets the requested objects from a GtkBuilder ui file. In case of error it returns FALSE and sets error_widget to a GtkLabel containing the error message to display.

filename :

the path to the gtk builder file

translation_domain :

the specific translation domain

root_objects :

a NULL terminated list of root objects to load or NULL to load all objects

error_widget :

a pointer were a GtkLabel

object_name :

the name of the first object

... :

a pointer were the first object is returned, followed by more name / object pairs and terminated by NULL.

Returns :

FALSE if an error occurs, TRUE on success.

gedit_utils_is_valid_location ()

gboolean            gedit_utils_is_valid_location       (GFile *location);

gedit_utils_location_get_dirname_for_display ()

gchar *             gedit_utils_location_get_dirname_for_display
                                                        (GFile *location);

Returns a string suitable to be displayed in the UI indicating the name of the directory where the file is located. For remote files it may also contain the hostname etc. For local files it tries to replace the home dir with ~.

location :

the location

Returns :

a string to display the dirname. [transfer full]

gedit_utils_set_direct_save_filename ()

gchar *             gedit_utils_set_direct_save_filename
                                                        (GdkDragContext *context);

gedit_utils_str_end_truncate ()

gchar *             gedit_utils_str_end_truncate        (const gchar *string,
                                                         guint truncate_length);