方法
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 坐标。也就是说,x
和 y
是相对事件坐标的。使用 gtk_tree_view_convert_widget_to_bin_window_coords() 转换小部件坐标。主要用于像弹出菜单这样的东西。如果 path
不是一个 NULL
指针,那么它将填入该点的 GtkTreePath
。应使用 gtk_tree_path_free() 释放此路径。如果 column
不是一个 NULL
指针,那么它将填入该点的列。cell_x
和 cell_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 版本以来已废弃
请使用 GtkListView
或 GtkColumnView
代替。
参数
x
-
类型:
int
要识别的 x 位置(相对于 bin_window)。
y
-
类型:
int
要识别的 y 位置(相对于 bin_window)。
path
-
类型:
GtkTreePath
一个指向填充的
GtkTreePath
指针的指针。该参数将由函数设置。 参数可以由方法设置为您。 参数可以是 NULL
。方法的调用者对返回的数据拥有所有权,并负责释放它。 column
-
一个指向要填充的
GtkTreeViewColumn
指针的指针。该参数将由函数设置。 参数可以由方法设置为您。 参数可以是 NULL
。返回的数据属于该实例。 cell_x
-
类型:
int*
一个放置与单元格相对的 X 坐标的指针。
该参数将由函数设置。 参数可以是 NULL
。 cell_y
-
类型:
int*
一个放置与单元格相对的 Y 坐标的指针。
该参数将由函数设置。 参数可以是 NULL
。