当前位置:Linux教程 - Linux - GTK入门导读(Tooltips物件)

GTK入门导读(Tooltips物件)



         7. Tooltips物件
    他们是当您停在某个物件(像按钮或其它物件)上几秒时, 会自动出现的一个小的文字视窗. 它们很容易使用, 因此我只解释一下, 而不给范例程式. 如果您想看看一些范例程式, 可参考GDK内的testgtk.c.

    有些物件(像标签)无法与tooltips一起用.

    第一个呼叫的函数会产生一个新的tooltip. 您只需要呼叫这个函数一次. GtkTooltip这个函数的返回值可用来产生许多个tooltips.


    GtkTooltips *gtk_tooltips_new (void);

    一旦您产生了一个新的tooltip, 您要设定到某个物件上, 只要呼叫这个函数即可.


    void gtk_tooltips_set_tips (GtkTooltips *tooltips,
    GtkWidget *widget,
    gchar *tips_text);

    第一个参数是您刚才产生的tooltip, 接著是您希望使用的物件, 然後是您希望显示的文字.

    这里有个简短的范例:


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


    tooltip还有其它的一些函数. 我只简短的介绍一下.


    void gtk_tooltips_destroy (GtkTooltips *tooltips);

    销毁tooltips.


    void gtk_tooltips_enable (GtkTooltips *tooltips);

    使一套已失效的tooltips生效.


    void gtk_tooltips_disable (GtkTooltips *tooltips);

    使一套tooltips生效.


    void gtk_tooltips_set_delay (GtkTooltips *tooltips,
    gint delay);

    设定要停留多少ms, tooltip才会出现. 内定值是1000ms, 即一秒.

    void gtk_tooltips_set_tips (GtkTooltips *tooltips,
    GtkWidget *widget,
    gchar *tips_text);

    改变一个tooltip的文字内容.


    void gtk_tooltips_set_colors (GtkTooltips *tooltips,
    GdkColor *background,
    GdkColor *foreground);

    设定tooltips的前景及背景颜色.

    发布人:netbull 来自:Linux开发指南