工具提示对象(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 ); |
禁用已经激活的工具提示对象。
上面是所有与工具提示有关的函数,实际上比你想要知道的还多 :-)