pidgin3: comparison pidgin/gtkutils.h

-:1edf059a4a26
+:5af898e91ec2
 * @return The GtkFrame containing the toolbar and imhtml.
 */
 GtkWidget *pidgin_create_imhtml(gboolean editable, GtkWidget **imhtml_ret, GtkWidget **toolbar_ret, GtkWidget **sw_ret);
 /**
+* Creates a new window
+*
+* @param title        The window title, or @c NULL
+* @param border_width The window's desired border width
+* @param role         A string indicating what the window is responsible for doing, or @c NULL
+* @param resizable    Whether the window should be resizable (@c TRUE) or not (@c FALSE)
+*
+* @since 2.1.0
+*/
+GtkWidget *pidgin_create_window(const char *title, guint border_width, const char *role, gboolean resizable);
+/**
 * Toggles the sensitivity of a widget.
 *
 * @param widget    @c NULL. Used for signal handlers.
 * @param to_toggle The widget to toggle.
 */
 /**
 * Adds a separator to a menu.
 *
 * @param menu The menu to add a separator to.
-*/
+*
-void pidgin_separator(GtkWidget *menu);
+* @return The separator.
+*/
+GtkWidget *pidgin_separator(GtkWidget *menu);
 /**
 * Creates a menu item.
 *
 * @param menu The menu to which to append the menu item.
 * Load menu accelerators
 */
 void pidgin_load_accels(void);
 /**
+* Get information about a user. Show immediate feedback.
+*
+* @param conn   The connection to get information from.
+* @param name   The user to get information about.
+*/
+void pidgin_retrieve_user_info(PurpleConnection *conn, const char *name);
+/**
+* Get information about a user in a chat. Show immediate feedback.
+*
+* @param conn   The connection to get information from.
+* @param name   The user to get information about.
+* @param chatid The chat id.
+*/
+void pidgin_retrieve_user_info_in_chat(PurpleConnection *conn, const char *name, int chatid);
+/**
 * Parses an application/x-im-contact MIME message and returns the
 * data inside.
 *
 * @param msg          The MIME message.
 * @param all_accounts If TRUE, check all compatible accounts, online or
 * @param l A GtkLabel that we want to use as the ATK name for the widget.
 */
 void pidgin_set_accessible_label(GtkWidget *w, GtkWidget *l);
 /**
-* A valid GtkMenuPositionFunc.  This is used to determine where
+* A helper function for GtkMenuPositionFuncs. This ensures the menu will
-* to draw context menu's when the menu is activated with the
+* be kept on screen if possible.
-* keyboard (shift+F10).  If the menu is activated with the mouse,
-* then you should just use GTK's built-in position function,
-* because it does a better job of positioning the menu.
 *
 * @param menu The menu we are positioning.
 * @param x Address of the gint representing the horizontal position
 *        where the menu shall be drawn. This is an output parameter.
 * @param y Address of the gint representing the vertical position
 *        where the menu shall be drawn. This is an output parameter.
 * @param push_in This is an output parameter?
 * @param user_data Not used by this particular position function.
 */
+void pidgin_menu_position_func_helper(GtkMenu *menu, gint *x, gint *y,
+										gboolean *push_in, gpointer data);
+/**
+* A valid GtkMenuPositionFunc.  This is used to determine where
+* to draw context menu's when the menu is activated with the
+* keyboard (shift+F10).  If the menu is activated with the mouse,
+* then you should just use GTK's built-in position function,
+* because it does a better job of positioning the menu.
+*
+* @param menu The menu we are positioning.
+* @param x Address of the gint representing the horizontal position
+*        where the menu shall be drawn. This is an output parameter.
+* @param y Address of the gint representing the vertical position
+*        where the menu shall be drawn. This is an output parameter.
+* @param push_in This is an output parameter?
+* @param user_data Not used by this particular position function.
+*/
 void pidgin_treeview_popup_menu_position_func(GtkMenu *menu,
 												gint *x,
 												gint *y,
 												gboolean *push_in,
 												gpointer user_data);
 * Append a PurpleMenuAction to a menu.
 *
 * @param menu    The menu to append to.
 * @param act     The PurpleMenuAction to append.
 * @param gobject The object to be passed to the action callback.
-*/
+*
-void pidgin_append_menu_action(GtkWidget *menu, PurpleMenuAction *act,
+* @return   The menuitem added.
+*/
+GtkWidget *pidgin_append_menu_action(GtkWidget *menu, PurpleMenuAction *act,
 gpointer gobject);
 /**
 * Sets the mouse pointer for a GtkWidget.
 *
 * @param pixbuf  The pixbug
 * @return TRUE if the pixbuf is opaque around the edges, FALSE otherwise
 */
 gboolean pidgin_gdk_pixbuf_is_opaque(GdkPixbuf *pixbuf);
+/**
+* Rounds the corners of a 32x32 GdkPixbuf in place
+*
+* @param pixbuf  The buddy icon to transform
+*/
+void pidgin_gdk_pixbuf_make_round(GdkPixbuf *pixbuf);
+/**
+* Returns an HTML-style color string for use as a dim grey
+* string
+*
+* @param widget  The widget to return dim grey for
+* @return The dim grey string
+*/
+const char *pidgin_get_dim_grey_string(GtkWidget *widget);
 #if !GTK_CHECK_VERSION(2,2,0)
 /**
 * This is copied from Gtk to support Gtk 2.0
 *
 * Creates a new path with @a first_index and the varargs as indices.

Mercurial > pidgin3 / file comparison

comparison: pidgin/gtkutils.h

pidgin/gtkutils.h