Mercurial > pidgin

comparison pidgin/gtkwebview.h @ 32082:25d99f3621bb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
removed some ugly pointless pieces of code.
author tdrhq@soc.pidgin.im
date Mon, 10 Aug 2009 07:47:37 +0000
parents b89351c7580b
children 1cebf9aa291a
comparison
equal deleted inserted replaced
32081:3bd8fb942ea4 32082:25d99f3621bb
101 * @return gboolean indicating whether the webview is empty. 101 * @return gboolean indicating whether the webview is empty.
102 */ 102 */
103 gboolean gtk_webview_is_empty (GtkWebView *webview); 103 gboolean gtk_webview_is_empty (GtkWebView *webview);
104 104
105 /** 105 /**
106 * Executes javascript and returns the answer of the script
107 * formatted as string. The return value needs to be freed using
108 * g_free. If the return values is not required you may instead
109 * use webkit_web_view_execute_script, or even better
110 * gtk_webview_safe_execute_script.
111 *
112 * @param webview The GtkWebView object
113 * @param script The JavaScript to execute
114 *
115 * @return the return value of the script.
116 */
117 char* gtk_webview_execute_script (GtkWebView *webview, const char *script);
118
119 /**
120 * Execute the JavaScript only after the webkit_webview_load_string 106 * Execute the JavaScript only after the webkit_webview_load_string
121 * loads completely. We also guarantee that the scripts are executed 107 * loads completely. We also guarantee that the scripts are executed
122 * in the order they are called here.This is useful to avoid race 108 * in the order they are called here.This is useful to avoid race
123 * conditions when calls JS functions immediately after opening the 109 * conditions when calls JS functions immediately after opening the
124 * page. 110 * page.
127 * @param script the script to execute 113 * @param script the script to execute
128 */ 114 */
129 void gtk_webview_safe_execute_script (GtkWebView *webview, const char* script); 115 void gtk_webview_safe_execute_script (GtkWebView *webview, const char* script);
130 116
131 /** 117 /**
132 * Get the current contents of the GtkWebView object.
133 *
134 * @param webview The GtkWebView object
135 *
136 * @return a string with the contents. Needs to be g_free'd after use.
137 */
138 char* gtk_webview_get_markup (GtkWebView *webview);
139
140 /**
141 * Returns the contents of the GtkWebView object, stripped of markups
142 *
143 * @param webview The GtkWebView object
144 *
145 * @return a string with the contents. Needs to be g_free'd after use.
146 */
147 char* gtk_webview_get_text (GtkWebView *view);
148
149 /**
150 * A convenience routine to quote a string for use as a JavaScript 118 * A convenience routine to quote a string for use as a JavaScript
151 * string. For instance, "hello 'world'" becomes "'hello \\'world\\''" 119 * string. For instance, "hello 'world'" becomes "'hello \\'world\\''"
152 * 120 *
153 * @param str The string to escape and quote 121 * @param str The string to escape and quote
154 * 122 *