工具提示对象 The Tooltips Object

工具提示对象(Tooltips)就是当鼠标指针移到按钮或其它构件上并停留几秒时,弹出的文本串。工具提示对象很容易使用,所以在此仅仅对它们进行解释,不再举例。如果你想要看些代码,可以看看 GTK 附带的testgtk.c程序.

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

可以使用 gtk_tooltips_new() 函数创建工具提示对象。因为GtkTooltips对象可以重复使用,一般在应用程序中仅需要调用这个函数一次。

GtkTooltips *gtk_tooltips_new( void );

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

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

第一个参数是已经创建的工具提示对象,其后第二个参数是希望弹出工具提示的构件,第三个参数是要弹出的文本。最后一个参数是作为标识符的文本串,当用GtkTipsQuery实现上下文敏感的帮助时要引用该标识符。目前,你可以把它设置为NULL.

下面有个短示例:

GtkTooltips *tooltips;
GtkWidget *button;
.
.
.
tooltips = gtk_tooltips_new ();
button = gtk_button_new_with_label ("button 1");
.
.
.
gtk_tooltips_set_tip (tooltips, button, "This is button 1", NULL);

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

void gtk_tooltips_enable( GtkTooltips *tooltips );

激活已经禁用的工具提示对象。

void gtk_tooltips_disable( GtkTooltips *tooltips );

禁用已经激活的工具提示对象。

上面是所有与工具提示有关的函数,实际上比你想要知道的还多 :-)