GtkTooltip

GtkTooltip — Добавление подсказок к виджетам

Функции

void	gtk_tooltip_set_markup ()
void	gtk_tooltip_set_text ()
void	gtk_tooltip_set_icon ()
void	gtk_tooltip_set_icon_from_icon_name ()
void	gtk_tooltip_set_icon_from_gicon ()
void	gtk_tooltip_set_custom ()
void	gtk_tooltip_set_tip_area ()

Типы и значения

GtkTooltip

Иерархия объектов

    GObject
    ╰── GtkTooltip

Файлы

#include <gtk/gtk.h>

Описание

Базовые подсказки можно реализовать просто, используя gtk_widget_set_tooltip_text() или gtk_widget_set_tooltip_markup() без явного объекта подсказки.

Когда вам нужна подсказка с более сложным содержимым, например, добавлением изображения, или вы хотите, чтобы подсказка имела разное содержимое для каждой строки или ячейки GtkTreeView, вам придётся немного поработать:

Установите свойство “has-tooltip” в TRUE, это позволит GTK отслеживать движение мыши и связанные события, которые необходимы для определения времени и места отображения подсказки.
Подключитесь к сигналу “query-tooltip”. Этот сигнал будет испускаться, когда предполагается отобразить подсказку. Одним из аргументов, передаваемых обработчику сигнала, является объект GtkTooltip. Это объект, который мы собираемся отобразить в качестве подсказки, и его можно изменить в вашем обработчике с помощью функций, таких как gtk_tooltip_set_icon(). Существуют функции для установки разметки подсказки, установки изображения по имени значка или даже вставки пользовательского виджета.

Верните TRUE из обработчика query-tooltip. Это заставит подсказку отобразиться. Если вы вернёте FALSE, она не будет отображена.

Функции

void
gtk_tooltip_set_markup (GtkTooltip *tooltip,
                        const char *markup);

Устанавливает текст всплывающей подсказки на markup , который отформатирован с использованием языка разметки текста Pango. Если markup равно NULL, метка будет скрыта.

Параметры

tooltip	a GtkTooltip
markup	строка разметки (см. формат разметки Pango) или `NULL`.	[allow-none]

void
gtk_tooltip_set_text (GtkTooltip *tooltip,
                      const char *text);

Устанавливает текст всплывающей подсказки на text . Если text равно NULL, метка будет скрыта. См. также gtk_tooltip_set_markup().

Параметры

tooltip	a GtkTooltip
text	строка текста или `NULL`.	[allow-none]

void
gtk_tooltip_set_icon (GtkTooltip *tooltip,
                      GdkPaintable *paintable);

Устанавливает значок всплывающей подсказки (который находится перед текстом) на paintable . Если paintable равно NULL, изображение будет скрыто.

Параметры

tooltip	a GtkTooltip
paintable	a GdkPaintable, или `NULL`.	[allow-none]

void
gtk_tooltip_set_icon_from_icon_name (GtkTooltip *tooltip,
                                     const char *icon_name);

Устанавливает значок всплывающей подсказки (который находится перед текстом) на значок, указанный в icon_name с размером, указанным в size . Если icon_name равно NULL, изображение будет скрыто.

Параметры

tooltip	a GtkTooltip
icon_name	имя значка, или `NULL`.	[allow-none]

void
gtk_tooltip_set_icon_from_gicon (GtkTooltip *tooltip,
                                 GIcon *gicon);

Устанавливает значок всплывающей подсказки (который находится перед текстом) на значок, указанный в gicon с размером, указанным в size . Если gicon равно NULL, изображение будет скрыто.

Параметры

tooltip	a GtkTooltip
gicon	a GIcon представляющий значок, или `NULL`.	[allow-none]

void
gtk_tooltip_set_custom (GtkTooltip *tooltip,
                        GtkWidget *custom_widget);

Заменяет виджет, упакованный во всплывающую подсказку, на custom_widget . custom_widget не будет уничтожен, когда всплывающая подсказка исчезнет. По умолчанию во всплывающую подсказку встраивается рамка с GtkImage и GtkLabel, которые можно настроить с помощью gtk_tooltip_set_markup() и gtk_tooltip_set_icon().

Параметры

tooltip	a GtkTooltip
custom_widget	a GtkWidget, или `NULL` для сброса старого настраиваемого виджета.	[allow-none]

void
gtk_tooltip_set_tip_area (GtkTooltip *tooltip,
                          const GdkRectangle *rect);

Устанавливает область виджета, к которой относятся содержимое этой всплывающей подсказки, на rect (в координатах виджета). Это особенно полезно для правильного размещения всплывающих подсказок на строках и ячейках GtkTreeView, GtkIconViews и т. д.

Для установки всплывающих подсказок на GtkTreeView, используйте удобные функции: gtk_tree_view_set_tooltip_row() и gtk_tree_view_set_tooltip_cell().

Параметры

tooltip	a GtkTooltip
rect	a GdkRectangle

Типы и значения

GtkTooltip

typedef struct _GtkTooltip GtkTooltip;

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkTooltip.html

GtkTooltip

Функции

Типы и значения

Иерархия объектов

Файлы

Описание

Функции

gtk_tooltip_set_markup ()

Параметры

gtk_tooltip_set_text ()

Параметры

gtk_tooltip_set_icon ()

Параметры

gtk_tooltip_set_icon_from_icon_name ()

Параметры

gtk_tooltip_set_icon_from_gicon ()

Параметры

gtk_tooltip_set_custom ()

Параметры

gtk_tooltip_set_tip_area ()

Параметры

Типы и значения

GtkTooltip