方法

GtkWidgetpick

声明 [源代码]

GtkWidget*
gtk_widget_pick (
  GtkWidget* widget,
  double x,
  double y,
  GtkPickFlags flags
)

描述 [源代码]

查找距离某点最近的控件子节点。

点 (x, y) 必须以控件坐标给出，因此 (0, 0) 被假定为 widget 内容区域的左上角。

通常，如果给定的坐标没有包含在通过 gtk_widget_contains() 检查的 widget 中，控件将返回 NULL。否则，它们会递归地尝试找到不返回 NULL 的子控件。然而，控件可以自定义它们的选取算法。

此函数在顶层中用于确定鼠标光标下的控件，以确定悬停高亮显示和传递事件的用途。

参数

x

类型： double

要测试的 X 坐标，相对于 widget 的原点。

y

类型： double

要测试的 Y 坐标，相对于 widget 的原点。

flags

类型： GtkPickFlags

影响选取的内容的标志。

返回值

类型： GtkWidget

位于 (x, y) 的控件子节点。

返回的数据由实例拥有。
返回值可以为 NULL。