gedit-utils: gedit Reference Manual

## gedit-utils gedit-utils |

## Functions

#define | GBOOLEAN_TO_POINTER()
#define | GPOINTER_TO_BOOLEAN()
gboolean | gedit_utils_menu_position_under_tree_view ()
void | gedit_utils_set_atk_name_description ()
void | gedit_warning ()
guint | gedit_utils_get_current_workspace ()
guint | gedit_utils_get_window_workspace ()
gchar * | gedit_utils_basename_for_display ()
gboolean | gedit_utils_decode_uri ()
gchar ** | gedit_utils_drop_get_uris ()
GtkSourceCompressionType | gedit_utils_get_compression_type_from_content_type ()
void | gedit_utils_get_current_viewport ()
gboolean | gedit_utils_is_valid_location ()
gchar * | gedit_utils_location_get_dirname_for_display ()
gchar * | gedit_utils_set_direct_save_filename ()
const gchar * | gedit_utils_newline_type_to_string ()
gchar * | gedit_utils_make_valid_utf8 ()
gchar * | gedit_utils_str_middle_truncate ()
gchar * | gedit_utils_str_end_truncate ()
gchar * | gedit_utils_replace_home_dir_with_tilde ()
void | gedit_utils_menu_position_under_widget ()
void | gedit_utils_set_atk_relation ()

## Description

## Functions

### 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))

### gedit_utils_menu_position_under_tree_view ()

    gboolean
    gedit_utils_menu_position_under_tree_view
                                   (GtkTreeView *tree_view,
                                    GdkRectangle *rect);

### 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.

#### Parameters

widget | The Gtk widget for which name/description to be set |
name | Atk name string |
description | Atk description string |

### gedit_warning ()

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

### 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.

#### Parameters

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.

#### Parameters

gtkwindow | a GtkWindow. |

#### Returns

the workspace the window is on.

### gedit_utils_basename_for_display ()

    gchar *
    gedit_utils_basename_for_display (GFile *location);

#### Parameters

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 **host,
                            gchar **port,
                            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

#### Parameters

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.

#### Parameters

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 ()

    GtkSourceCompressionType
    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.

#### Parameters

screen | a GdkScreen |
x | x-axis point. | [out]
y | y-axis point. | [out]

### 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 ~.

#### Parameters

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_newline_type_to_string ()

    const gchar *
    gedit_utils_newline_type_to_string (GtkSourceNewlineType newline_type);

### gedit_utils_make_valid_utf8 ()

    gchar *
    gedit_utils_make_valid_utf8 (const char *name);

`gedit_utils_make_valid_utf8` has been deprecated since version 3.36 and should not be used in newly-written code.

Use `g_utf8_make_valid()` instead.

### gedit_utils_str_middle_truncate ()

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

`gedit_utils_str_middle_truncate` has been deprecated since version 3.36 and should not be used in newly-written code.

Use `tepl_utils_str_middle_truncate()` instead.

### gedit_utils_str_end_truncate ()

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

`gedit_utils_str_end_truncate` has been deprecated since version 3.36 and should not be used in newly-written code.

Use `tepl_utils_str_end_truncate()` instead.

### gedit_utils_replace_home_dir_with_tilde ()

    gchar *
    gedit_utils_replace_home_dir_with_tilde
                                   (const gchar *uri);

`gedit_utils_replace_home_dir_with_tilde` has been deprecated since version 3.36 and should not be used in newly-written code.

Use `tepl_utils_replace_home_dir_with_tilde()` instead.

### 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_widget` has been deprecated since version 3.36 and should not be used in newly-written code.

Use `gtk_menu_popup_at_widget()` instead.

### gedit_utils_set_atk_relation ()

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

`gedit_utils_set_atk_relation` has been deprecated since version 3.36 and should not be used in newly-written code.

This function is no longer used by gedit. If you need it, copy it.

This function establishes atk relation between 2 specified widgets.

#### Parameters

obj1 | specified widget. |
obj2 | specified widget. |
rel_type | the type of relation to set up. |