方法

GtkTreeViewget_path_at_pos

已废弃:4.10 

声明 [src]

gboolean
gtk_tree_view_get_path_at_pos (
  GtkTreeView* tree_view,
  int x,
  int y,
  GtkTreePath** path,
  GtkTreeViewColumn** column,
  int* cell_x,
  int* cell_y
)

描述 [src]

查找在点 (x, y) 的路径,相对于 bin_window 坐标。也就是说,xy 是相对事件坐标的。使用 gtk_tree_view_convert_widget_to_bin_window_coords() 转换小部件坐标。主要用于像弹出菜单这样的东西。如果 path 不是一个 NULL 指针,那么它将填入该点的 GtkTreePath。应使用 gtk_tree_path_free() 释放此路径。如果 column 不是一个 NULL 指针,那么它将填入该点的列。cell_xcell_y 返回相对于单元格背景的坐标(换句话说,传递给 gtk_cell_RENDERER_Render() 的 background_area)。仅在 tree_view 已实现时,此函数才有意义。因此,如果 tree_view 未实现或没有模型,此函数将始终返回 FALSE

有关转换小部件坐标(例如您从 GtkWidget::query-tooltip 获取的坐标),请参阅 gtk_tree_view_convert_widget_to_bin_window_coords()。

自 4.10 版本以来已废弃

请使用 GtkListViewGtkColumnView 代替。

参数

x

类型: int

要识别的 x 位置(相对于 bin_window)。

y

类型: int

要识别的 y 位置(相对于 bin_window)。

path

类型: GtkTreePath

一个指向填充的 GtkTreePath 指针的指针。

该参数将由函数设置。
参数可以由方法设置为您。
参数可以是 NULL
方法的调用者对返回的数据拥有所有权,并负责释放它。
column

类型: GtkTreeViewColumn

一个指向要填充的 GtkTreeViewColumn 指针的指针。

该参数将由函数设置。
参数可以由方法设置为您。
参数可以是 NULL
返回的数据属于该实例。
cell_x

类型: int*

一个放置与单元格相对的 X 坐标的指针。

该参数将由函数设置。
参数可以是 NULL
cell_y

类型: int*

一个放置与单元格相对的 Y 坐标的指针。

该参数将由函数设置。
参数可以是 NULL

返回值

类型: gboolean

TRUE 如果在该坐标处存在一行。