* GNT - The GLib Ncurses Toolkit * GNT is the legal property of its developers, whose names are too numerous * to list here. Please refer to the COPYRIGHT file distributed with this * This library 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 Street, Fifth Floor, Boston, MA 02111-1301 USA * @section_id: libgnt-gntutils * @short_description: <filename>gntutils.h</filename> * @title: Utility functions typedef gpointer (*GntDuplicateFunc)(gconstpointer data); * gnt_util_get_text_bound: * @text: The text to be displayed. * @width: The width required is set here, if not %NULL. * @height: The height required is set here, if not %NULL. * Compute the width and height required to view the text on the screen. void gnt_util_get_text_bound(const char *text, int *width, int *height); * gnt_util_onscreen_width: * @start: The beginning of the string. * @end: The end of the string. The width returned is the width * upto (but not including) end. If end is NULL, then start * is considered as a %NULL-terminated string. * Get the onscreen width of a string, or a substring. * Returns: The on-screen width of the string. int gnt_util_onscreen_width(const char *start, const char *end); * gnt_util_onscreen_width_to_pointer: * @len: The length to consider. If non-positive, the entire screenlength is used. * @w: The actual width of the string upto the returned offset, if not %NULL. * Computes and returns the string after a specific number of onscreen characters. * Returns: The string after len offset. const char *gnt_util_onscreen_width_to_pointer(const char *str, int len, int *w); * gnt_util_onscreen_fit_string: * @maxw: The width that the string should fit into. If maxw is <= 0, * then the available maximum width is used. * Inserts newlines in 'string' where necessary so that its onscreen width is * Returns: A newly allocated string that needs to be freed by the caller. char * gnt_util_onscreen_fit_string(const char *string, int maxw); * gnt_hash_table_duplicate: * @src: The source hashtable. * @hash: (scope call): The hash-function to use. * @equal: The hash-equal function to use. * @key_d: The key-destroy function to use. * @value_d: The value-destroy function to use. * @key_dup: (scope call): The function to use to duplicate the key. * @value_dup: (scope call): The function to use to duplicate the value. * Duplicate the contents of a hastable. * Returns: (transfer full): The new hashtable. GHashTable * gnt_hash_table_duplicate(GHashTable *src, GHashFunc hash, GEqualFunc equal, GDestroyNotify key_d, GDestroyNotify value_d, GntDuplicateFunc key_dup, GntDuplicateFunc value_dup); * gnt_boolean_handled_accumulator: * To be used with g_signal_new. Look in the key_pressed signal-definition in gboolean gnt_boolean_handled_accumulator(GSignalInvocationHint *ihint, GValue *return_accu, const GValue *handler_return, gpointer dummy); * gnt_widget_bindings_view: * @widget: The widget to get bindings for. * Get a helpful display about the bindings of a widget. * Returns: (transfer full): Returns a GntTree populated with "key" -> "binding" GntWidget * gnt_widget_bindings_view(GntWidget *widget); * gnt_util_parse_widgets: * @string: The XML string. * @num: The number of widgets to return, followed by 'num' GntWidget ** * Parse widgets from an XML description. For example, * GntWidget *win, *button; * gnt_util_parse_widgets("\ * <vwindow id='0' fill='0' align='2'> \ * <label>This is a test</label> \ * <button id='1'>OK</button> \ void gnt_util_parse_widgets(const char *string, int num, ...); * gnt_util_parse_xhtml_to_textview: * @string: The XHTML string * Parse an XHTML string and add it in a GntTextView with * appropriate text flags. * Returns: %TRUE if the string was added to the textview properly, %FALSE otherwise. gboolean gnt_util_parse_xhtml_to_textview(const char *string, GntTextView *tv); * gnt_util_set_trigger_widget: * @key: The key to trigger the button * @button: The button to trigger * Make some keypress activate a button when some key is pressed with 'wid' in focus. * Since: 2.0.0 (gnt), 2.1.0 (pidgin) void gnt_util_set_trigger_widget(GntWidget *widget, const char *key, GntWidget *button);