信号

GtkWidget::query-tooltip

声明

gboolean
query_tooltip (
  GtkWidget* self,
  gint x,
  gint y,
  gboolean keyboard_mode,
  GtkTooltip* tooltip,
  gpointer user_data
)

描述 [src]

当小部件的提示即将显示时发出。

这发生在 GtkWidget:has-tooltip 属性为真且鼠标悬停时间超时,光标悬停在 widget 上时;或者当 widget 在键盘模式下获得焦点时发出。

使用给定的坐标,信号处理器应确定是否应该为 widget 显示提示。如果是这种情况,应返回 true,否则返回 false。注意,如果 keyboard_mode 为 true,则 xy 的值是未定义的,不应使用。

信号处理器可以自由使用因此预定功能的函数调用来操作 tooltip

默认处理程序

默认处理程序在通过 g_signal_connect() 添加的处理程序之后调用。

参数

x

类型: gint

光标位置的 x 坐标,以小部件坐标为单位。

y

类型: gint

光标位置的 y 坐标,以小部件坐标为单位。

keyboard_mode

类型: gboolean

如果提示是通过键盘触发的,则为真。

tooltip

类型: GtkTooltip

A GtkTooltip.

数据由函数的调用者拥有。

返回值

类型: gboolean

如果现在应该显示 tooltip,则为 true,否则为 false。