Commit 9a4e3371 authored by Javier Jardón's avatar Javier Jardón

Remove GtkTooltips completely

parent 3d6b45f7
......@@ -4224,31 +4224,6 @@ gtk_toggle_tool_button_get_type
GtkToggleToolButtonPrivate
</SECTION>
<SECTION>
<FILE>gtktooltips</FILE>
<TITLE>GtkTooltips</TITLE>
GtkTooltips
GtkTooltipsData
gtk_tooltips_new
gtk_tooltips_enable
gtk_tooltips_disable
gtk_tooltips_set_delay
gtk_tooltips_set_tip
gtk_tooltips_data_get
gtk_tooltips_force_window
gtk_tooltips_get_info_from_tip_window
<SUBSECTION Standard>
GTK_TOOLTIPS
GTK_IS_TOOLTIPS
GTK_TYPE_TOOLTIPS
GTK_TOOLTIPS_CLASS
GTK_IS_TOOLTIPS_CLASS
GTK_TOOLTIPS_GET_CLASS
<SUBSECTION Private>
gtk_tooltips_get_type
</SECTION>
<SECTION>
<FILE>gtktoolitemgroup</FILE>
<TITLE>GtkToolItemGroup</TITLE>
......
......@@ -166,7 +166,6 @@ gtk_tool_button_get_type
gtk_tool_item_get_type
gtk_tool_item_group_get_type
gtk_tool_palette_get_type
gtk_tooltips_get_type
gtk_tree_drag_dest_get_type
gtk_tree_drag_source_get_type
gtk_tree_get_type
......
<!-- ##### SECTION Title ##### -->
GtkTooltips
<!-- ##### SECTION Short_Description ##### -->
Add tips to your widgets
<!-- ##### SECTION Long_Description ##### -->
<para>
#GtkTooltips has been deprecated in GTK+ 2.12, in favor of the new
#GtkTooltip API.
</para>
<para>
Tooltips are the messages that appear next to a widget when the mouse pointer is held over it for a short amount of time. They are especially helpful for adding more verbose descriptions of things such as buttons in a toolbar.
</para>
<para>
An individual tooltip belongs to a group of tooltips. A group is created with a call to gtk_tooltips_new(). Every tooltip in the group can then be turned off with a call to gtk_tooltips_disable() and enabled with gtk_tooltips_enable().
</para>
<para>
The length of time the user must keep the mouse over a widget before the tip is shown, can be altered with gtk_tooltips_set_delay(). This is set on a 'per group of tooltips' basis.
</para>
<para>
To assign a tip to a particular #GtkWidget, gtk_tooltips_set_tip() is used.
</para>
<note>
<para>
Tooltips can only be set on widgets which have their own X window and
receive enter and leave events.
To check if a widget has its own window use GTK_WIDGET_NO_WINDOW().
To add a tooltip to a widget that doesn't have its own window, place the
widget inside a #GtkEventBox and add a tooltip to that instead.
</para>
</note>
<para>
The default appearance of all tooltips in a program is determined by the current GTK+ theme that the user has selected.
</para>
<para>
Information about the tooltip (if any) associated with an arbitrary widget can be retrieved using gtk_tooltips_data_get().
</para>
<para>
<example>
<title>Adding tooltips to buttons.</title>
<programlisting>
GtkWidget *load_button, *save_button, *hbox;
GtkTooltips *button_bar_tips;
button_bar_tips = gtk_tooltips_new (<!-- -->);
/* Create the buttons and pack them into a GtkHBox */
hbox = gtk_hbox_new (TRUE, 2);
load_button = gtk_button_new_with_label ("Load a file");
gtk_box_pack_start (GTK_BOX (hbox), load_button, TRUE, TRUE, 2);
gtk_widget_show (load_button);
save_button = gtk_button_new_with_label ("Save a file");
gtk_box_pack_start (GTK_BOX (hbox), save_button, TRUE, TRUE, 2);
gtk_widget_show (save_button);
gtk_widget_show (hbox);
/* Add the tips */
gtk_tooltips_set_tip (GTK_TOOLTIPS (button_bar_tips), load_button,
"Load a new document into this window",
"Requests the filename of a document.
This will then be loaded into the current
window, replacing the contents of whatever
is already loaded.");
gtk_tooltips_set_tip (GTK_TOOLTIPS (button_bar_tips), save_button,
"Saves the current document to a file",
"If you have saved the document previously,
then the new version will be saved over the
old one. Otherwise, you will be prompted for
a filename.");
</programlisting></example>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
<variablelist>
<varlistentry>
<term>#GtkToolbar</term>
<listitem><para>Create groups of widgets with their own tooltips.</para></listitem>
</varlistentry>
<varlistentry>
<term>#GtkTipsQuery</term>
<listitem><para>Query tooltips to create context-sensitive help.</para></listitem>
</varlistentry>
</variablelist>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkTooltips ##### -->
<para>Holds information about a group of tooltips. Fields should be changed using the functions provided, rather than directly accessing the struct's members.
</para>
<!-- ##### STRUCT GtkTooltipsData ##### -->
<para>
<structfield>tooltips</structfield> is the #GtkTooltips group that this tooltip belongs to. <structfield>widget</structfield> is the #GtkWidget that this tooltip data is associated with. <structfield>tip_text</structfield> is a string containing the tooltip message itself.</para>
<para>
<structfield>tip_private</structfield> is a string that is not shown as the default tooltip. Instead, this message may be more informative and go towards forming a context-sensitive help system for your application. (FIXME: how to actually "switch on" private tips?)
</para>
@tooltips:
@widget:
@tip_text:
@tip_private:
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_new ##### -->
<para>
Creates an empty group of tooltips. This function initialises a #GtkTooltips structure. Without at least one such structure, you can not add tips to your application.
</para>
@Returns: a new #GtkTooltips group for you to use.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_enable ##### -->
<para>
Allows the user to see your tooltips as they navigate your application.
</para>
@tooltips: a #GtkTooltips.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_disable ##### -->
<para>
Causes all tooltips in @tooltips to become inactive. Any widgets that have tips associated with that group will no longer display their tips until they are enabled again with gtk_tooltips_enable().
</para>
@tooltips: a #GtkTooltips.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_set_delay ##### -->
<para>
Sets the time between the user moving the mouse over a widget and the widget's tooltip appearing.
</para>
@tooltips: a #GtkTooltips.
@delay: an integer value representing milliseconds.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_set_tip ##### -->
@tooltips:
@widget:
@tip_text:
@tip_private:
<!-- ##### FUNCTION gtk_tooltips_data_get ##### -->
<para>
Retrieves any #GtkTooltipsData previously associated with the given widget.
</para>
@widget: a #GtkWidget.
@Returns: a #GtkTooltipsData struct, or %NULL if the widget has no tooltip.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_force_window ##### -->
<para>
Ensures that the window used for displaying the given @tooltips is created.
</para>
<para>
Applications should never have to call this function, since GTK+ takes
care of this.
</para>
@tooltips: a #GtkToolTips
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_get_info_from_tip_window ##### -->
<para>
</para>
@tip_window:
@tooltips:
@current_widget:
@Returns:
@Deprecated: 2.12:
......@@ -3837,22 +3837,6 @@ gtk_tooltip_trigger_tooltip_query
#endif
#endif
#if IN_HEADER(__GTK_TOOLTIPS_H__)
#if IN_FILE(__GTK_TOOLTIPS_C__)
#ifndef GTK_DISABLE_DEPRECATED
gtk_tooltips_data_get
gtk_tooltips_disable
gtk_tooltips_enable
gtk_tooltips_force_window
gtk_tooltips_get_info_from_tip_window
gtk_tooltips_get_type G_GNUC_CONST
gtk_tooltips_new
gtk_tooltips_set_delay
gtk_tooltips_set_tip
#endif
#endif
#endif
#if IN_HEADER(__GTK_TRAY_ICON_H__)
#if IN_FILE(__GTK_TRAY_ICON_X11_C__)
#ifndef G_OS_WIN32
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment