1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
/*
* pluma-utils.h
* This file is part of pluma
*
* Copyright (C) 1998, 1999 Alex Roberts, Evan Lawrence
* Copyright (C) 2000, 2001 Chema Celorio, Paolo Maggi
* Copyright (C) 2002 - 2005 Paolo Maggi
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
/*
* Modified by the pluma Team, 1998-2005. See the AUTHORS file for a
* list of people on the pluma Team.
* See the ChangeLog files for a list of changes.
*
* $Id$
*/
#ifndef __PLUMA_UTILS_H__
#define __PLUMA_UTILS_H__
#include <glib.h>
#include <gtk/gtk.h>
#include <atk/atk.h>
#include <pluma/pluma-encodings.h>
G_BEGIN_DECLS
/* useful macro */
#define GBOOLEAN_TO_POINTER(i) (GINT_TO_POINTER ((i) ? 2 : 1))
#define GPOINTER_TO_BOOLEAN(i) ((gboolean) ((GPOINTER_TO_INT(i) == 2) ? TRUE : FALSE))
#define IS_VALID_BOOLEAN(v) (((v == TRUE) || (v == FALSE)) ? TRUE : FALSE)
enum { PLUMA_ALL_WORKSPACES = 0xffffffff };
gboolean pluma_utils_uri_has_writable_scheme (const gchar *uri);
gboolean pluma_utils_uri_has_file_scheme (const gchar *uri);
void pluma_utils_menu_position_under_widget (GtkMenu *menu,
gint *x,
gint *y,
gboolean *push_in,
gpointer user_data);
void menu_popup_at_treeview_selection (GtkWidget *menu,
GtkWidget *treeview);
GtkWidget *pluma_gtk_button_new_with_icon (const gchar *label,
const gchar *icon_name);
GtkWidget *pluma_dialog_add_button (GtkDialog *dialog,
const gchar *text,
const gchar *icon_name,
gint response_id);
gchar *pluma_utils_escape_underscores (const gchar *text,
gssize length);
gchar *pluma_utils_str_middle_truncate (const gchar *string,
guint truncate_length);
gchar *pluma_utils_str_end_truncate (const gchar *string,
guint truncate_length);
gboolean g_utf8_caselessnmatch (const char *s1,
const char *s2,
gssize n1,
gssize n2);
void pluma_utils_set_atk_name_description (GtkWidget *widget,
const gchar *name,
const gchar *description);
void pluma_utils_set_atk_relation (GtkWidget *obj1,
GtkWidget *obj2,
AtkRelationType rel_type);
gboolean pluma_utils_uri_exists (const gchar* text_uri);
gchar *pluma_utils_escape_search_text (const gchar *text);
gchar *pluma_utils_unescape_search_text (const gchar *text);
void pluma_warning (GtkWindow *parent,
const gchar *format,
...) G_GNUC_PRINTF(2, 3);
gchar *pluma_utils_make_valid_utf8 (const char *name);
/* Note that this function replace home dir with ~ */
gchar *pluma_utils_uri_get_dirname (const char *uri);
gchar *pluma_utils_location_get_dirname_for_display
(GFile *location);
gchar *pluma_utils_replace_home_dir_with_tilde (const gchar *uri);
guint pluma_utils_get_current_workspace (GdkScreen *screen);
guint pluma_utils_get_window_workspace (GtkWindow *gtkwindow);
void pluma_utils_get_current_viewport (GdkScreen *screen,
gint *x,
gint *y);
gboolean pluma_utils_is_valid_uri (const gchar *uri);
gboolean pluma_utils_get_ui_objects (const gchar *filename,
gchar **root_objects,
GtkWidget **error_widget,
const gchar *object_name,
...) G_GNUC_NULL_TERMINATED;
gboolean pluma_utils_file_has_parent (GFile *gfile);
/* Return NULL if str is not a valid URI and/or filename */
gchar *pluma_utils_make_canonical_uri_from_shell_arg
(const gchar *str);
gchar *pluma_utils_uri_for_display (const gchar *uri);
gchar *pluma_utils_basename_for_display (const gchar *uri);
gboolean pluma_utils_decode_uri (const gchar *uri,
gchar **scheme,
gchar **user,
gchar **port,
gchar **host,
gchar **path);
/* Turns data from a drop into a list of well formatted uris */
gchar **pluma_utils_drop_get_uris (GtkSelectionData *selection_data);
/* Provides regexp forward search */
gboolean
pluma_gtk_text_iter_regex_search (const GtkTextIter *iter,
const gchar *str,
GtkTextSearchFlags flags,
GtkTextIter *match_start,
GtkTextIter *match_end,
const GtkTextIter *limit,
gboolean forward_search,
gchar **replace_text);
GtkWidget *
pluma_image_menu_item_new_from_pixbuf (GdkPixbuf *icon_pixbuf,
const gchar *label_name);
G_END_DECLS
#endif /* __PLUMA_UTILS_H__ */
|
