类
GtkTooltip
描述 [src]
final class Gtk.Tooltip : GObject.Object
{
/* No available fields */
}
GtkTooltip
是表示小部件 tooltip 的对象。
基本 tooltip 可以利用 gtk_widget_set_tooltip_text()
或 gtk_widget_set_tooltip_markup()
轻松实现,不需要任何明确的 tooltip 对象。
在需要显示更美观内容的 tooltip 时(例如添加图像),或者需要让 tooltip 对不同的 GtkTreeView
行或单元格有不同的内容,那么需要做更多工作。
-
将
GtkWidget:has-tooltip
属性设置为TRUE
。该操作会使 GTK 监控小部件的运动和相关事件,这些事件是确定在何时何地显示 tooltip 所必需的。 -
连接到
GtkWidget::query-tooltip
信号。当 tooltip 应显示时,将发出此信号。传递给信号处理程序的参数之一是GtkTooltip
对象。这是我们准备作为 tooltip 显示的对象,并且可以在回调中使用类似gtk_tooltip_set_icon()
的函数对其进行操作。要设置 tooltip 的标记、从命名图标设置图像,甚至放入自定义小部件,有一些函数。 -
从 ::query-tooltip 处理程序返回
TRUE
。这将导致显示 tooltip。如果返回FALSE
,则 tooltip 将不会显示。
实例方法
gtk_tooltip_set_custom
将打包到 tooltip 中的小部件替换为 custom_widget
。当 tooltip 消失时,不会销毁 custom_widget
。默认情况下,一个包含 GtkImage
和 GtkLabel
的框嵌入到 tooltip 中,可以使用 gtk_tooltip_set_markup()
和 gtk_tooltip_set_icon() 进行配置。
gtk_tooltip_set_icon_from_gicon
将 tooltip 的图标(位于文本前面)设置为由 gicon
表示的图标,其大小由 size
表示。如果 gicon
为 NULL
,则图像将隐藏。
gtk_tooltip_set_icon_from_icon_name
将 tooltip 的图标(位于文本前面)设置为由 icon_name
表示的图标,其大小由 size
表示。如果 icon_name
为 NULL
,则图像将隐藏。
gtk_tooltip_set_tip_area
将小部件的区域(此 tooltip 的内容适用于该区域)设置为 rect
(以小部件坐标表示)。这对在 GtkTreeView
行和单元格、GtkIconViews
等上正确设置 tooltip 非常有用。
信号
从 GObject (1)继承的信号
GObject::notify
当通过 g_object_set_property()、g_object_set() 等方式设置对象某个属性的值后,会发出 notify 信号。