pidgintooltip.h File Reference

Pidgin Tooltip API. More...

#include <gtk/gtk.h>

Go to the source code of this file.

Typedefs
typedef gboolean(*	PidginTooltipCreateForTree )(GtkWidget *tipwindow, GtkTreePath *path, gpointer userdata, int *w, int *h)
typedef gboolean(*	PidginTooltipCreate )(GtkWidget *tipwindow, gpointer userdata, int *w, int *h)
typedef gboolean(*	PidginTooltipPaint )(GtkWidget *tipwindow, gpointer userdata)
Functions
gboolean	pidgin_tooltip_setup_for_treeview (GtkWidget *tree, gpointer userdata, PidginTooltipCreateForTree create_cb, PidginTooltipPaint paint_cb)
	Setup tooltip drawing functions for a treeview.
gboolean	pidgin_tooltip_setup_for_widget (GtkWidget *widget, gpointer userdata, PidginTooltipCreate create_cb, PidginTooltipPaint paint_cb)
	Setup tooltip drawing functions for any widget.
void	pidgin_tooltip_destroy (void)
	Destroy the tooltip.
void	pidgin_tooltip_show (GtkWidget *widget, gpointer userdata, PidginTooltipCreate create_cb, PidginTooltipPaint paint_cb)
	Create and show a tooltip.

---

Detailed Description

Pidgin Tooltip API.

Definition in file pidgintooltip.h.

---

Typedef Documentation

typedef gboolean(* PidginTooltipCreate)(GtkWidget *tipwindow, gpointer userdata, int *w, int *h)

Parameters:

	tipwindow	The window for the tooltip.
	userdata	The userdata set during pidgin_tooltip_show.
	w	The value of this should be set to the desired width of the tooltip window.
	h	The value of this should be set to the desired height of the tooltip window.

Returns:

TRUE if the tooltip was created correctly, FALSE otherwise.

Since:

2.4.0

Definition at line 53 of file pidgintooltip.h.

typedef gboolean(* PidginTooltipCreateForTree)(GtkWidget *tipwindow, GtkTreePath *path, gpointer userdata, int *w, int *h)

Parameters:

	tipwindow	The window for the tooltip.
	path	The GtkTreePath representing the row under the cursor.
	userdata	The userdata set during pidgin_tooltip_setup_for_treeview.
	w	The value of this should be set to the desired width of the tooltip window.
	h	The value of this should be set to the desired height of the tooltip window.

Returns:

TRUE if the tooltip was created correctly, FALSE otherwise.

Since:

2.4.0

Definition at line 41 of file pidgintooltip.h.

typedef gboolean(* PidginTooltipPaint)(GtkWidget *tipwindow, gpointer userdata)

Parameters:

	tipwindow	The window for the tooltip.
	userdata	The userdata set during pidgin_tooltip_setup_for_treeview or pidgin_tooltip_show.

Returns:

TRUE if the tooltip was painted correctly, FALSE otherwise.

Since:

2.4.0

Definition at line 63 of file pidgintooltip.h.

---

Function Documentation

void pidgin_tooltip_destroy

(

void

)

Destroy the tooltip.

Since:

2.4.0

gboolean pidgin_tooltip_setup_for_treeview	(	GtkWidget *	tree,
		gpointer	userdata,
		PidginTooltipCreateForTree	create_cb,
		PidginTooltipPaint	paint_cb
	)

Setup tooltip drawing functions for a treeview.

Parameters:

	tree	The treeview
	userdata	The userdata to send to the callback functions
	create_cb	Callback function to create the tooltip for a GtkTreePath
	paint_cb	Callback function to paint the tooltip

Returns:

TRUE if the tooltip callbacks were setup correctly.

Since:

2.4.0

gboolean pidgin_tooltip_setup_for_widget	(	GtkWidget *	widget,
		gpointer	userdata,
		PidginTooltipCreate	create_cb,
		PidginTooltipPaint	paint_cb
	)

Setup tooltip drawing functions for any widget.

Parameters:

	widget	The widget
	userdata	The userdata to send to the callback functions
	create_cb	Callback function to create the tooltip for the widget
	paint_cb	Callback function to paint the tooltip

Returns:

TRUE if the tooltip callbacks were setup correctly.

Since:

2.4.0

void pidgin_tooltip_show	(	GtkWidget *	widget,
		gpointer	userdata,
		PidginTooltipCreate	create_cb,
		PidginTooltipPaint	paint_cb
	)

Create and show a tooltip.

Parameters:

	widget	The widget the tooltip is for
	userdata	The userdata to send to the callback functions
	create_cb	Callback function to create the tooltip from the GtkTreePath
	paint_cb	Callback function to paint the tooltip

Since:

2.4.0