工具提示对象 The Tooltips Object

工具提示对象(Tooltips)就是当鼠标指针移到按钮或其它控件上并停留几秒时，弹出的字符串内容。

工具提示对象很容易使用，所以在此仅仅对它们进行解释，不再举例。如果你想要看些代码，可以看看 GTK 附带的testgtk.c程序．

注意：
不接收事件的控件(没有自己的 X 窗口的控件)不能和工具提示对象一起工作。

GtkTooltips *gtk_tooltips_new( void )

可以使用 gtk_tooltips_new() 函数创建工具提示对象。

因为GtkTooltips对象可以重复使用，一般在应用程序中仅需要调用这个函数一次。

GtkTooltips *gtk_tooltips_new( void );

void gtk_tooltips_set_tip( … )

一旦已创建新的工具提示，并且希望在某个控件上应用它，可调用以下函数设置它：

void gtk_tooltips_set_tip( GtkTooltips *tooltips,
                           GtkWidget   *widget,
                           const gchar *tip_text,
                           const gchar *tip_private );

参数：

• tooltips
  该参数是已经创建的工具提示对象，
• widget
  该参数是希望弹出工具提示的控件，
• tip_text
  该参数是要弹出的文本。
• tip_private
  该参数是作为标识符的文本串，当用GtkTipsQuery实现上下文敏感的帮助时要引用该标识符。目前,你可以把它设置为NULL．

其它2个相关函数

还有其它与工具提示有关的函数，下面仅仅列出一些函数的简要描述。

//激活已经禁用的工具提示对象
void gtk_tooltips_enable( GtkTooltips *tooltips );

//禁用已经激活的工具提示对象。
void gtk_tooltips_disable( GtkTooltips *tooltips );

上面是所有与工具提示有关的函数，实际上比你想要知道的还多 ^_^

示例

下面有个短示例：

    GtkTooltips *tooltips;
    GtkWidget *button;
    .
    .
    .
    tooltips = gtk_tooltips_new ();
    button = gtk_button_new_with_label ("button 1");
    .
    .
    .
    //为上面创建的button按钮增加提示内容: This is button 1
    gtk_tooltips_set_tip (tooltips, button, "This is button 1", NULL);