объект tooltips (инструмент подсказок)

это небольшие строчки текста, которые появляются рядом с указателем мыши при задержке курсора на каком нибудь из виджетов в течении короткого промежутка времени. они очень удобны в использовании. здесь не приводится пример их использования, но вы если хотите можете посмотреть код программмы testgtk.c поставляемой с дистрибутивом gtk.

виджеты, которые не получают события (не имеют собственного окна) не будут работать с tooltips.

первый вызов который вы будете использовать для создания нового tooltip. вам нужно только один раз установить tooltips как gtktooltips object для многократного использования этой функции при создании подсказок.

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 );

отключает включенную подсказку.

это все функции которые связаны с всплывающими подсказками. намного больше чем вам нужно знать :-)