GTK+ 2.0 教学-Tooltips物件

工具提示物件(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 );

停用已经启用的工具提示物件。

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

Comments are closed.