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 将不会显示。

层次结构

hierarchy this GtkTooltip ancestor_0 GObject ancestor_0--this

祖先

实例方法

gtk_tooltip_set_custom

将打包到 tooltip 中的小部件替换为 custom_widget。当 tooltip 消失时,不会销毁 custom_widget。默认情况下,一个包含 GtkImageGtkLabel 的框嵌入到 tooltip 中,可以使用 gtk_tooltip_set_markup() 和 gtk_tooltip_set_icon() 进行配置。

gtk_tooltip_set_icon

将 tooltip 的图标(位于文本前面)设置为 paintable。如果 paintableNULL,则图像将隐藏。

gtk_tooltip_set_icon_from_gicon

将 tooltip 的图标(位于文本前面)设置为由 gicon 表示的图标,其大小由 size 表示。如果 giconNULL,则图像将隐藏。

gtk_tooltip_set_icon_from_icon_name

将 tooltip 的图标(位于文本前面)设置为由 icon_name 表示的图标,其大小由 size 表示。如果 icon_nameNULL,则图像将隐藏。

gtk_tooltip_set_markup

将 tooltip 的文本设置为 markup

gtk_tooltip_set_text

将 tooltip 的文本设置为 text

gtk_tooltip_set_tip_area

将小部件的区域(此 tooltip 的内容适用于该区域)设置为 rect(以小部件坐标表示)。这对在 GtkTreeView 行和单元格、GtkIconViews 等上正确设置 tooltip 非常有用。

GObject 继承的方法 (43)

如需了解方法的完整列表,请参阅 GObject

信号

GObject (1)继承的信号
GObject::notify

当通过 g_object_set_property()、g_object_set() 等方式设置对象某个属性的值后,会发出 notify 信号。