matplotlib.widgets.ToolLineHandles

class matplotlib.widgets.ToolLineHandles(ax, positions, direction, *, line_props=None, useblit=True)

用于画布工具的控制手柄。

参数:

axAxes

显示工具句柄的 Matplotlib 坐标轴（Axes）。

positions一维数组

数据坐标系中句柄的位置。

direction{"horizontal", "vertical"}

句柄的方向，可选 'vertical'（垂直）或 'horizontal'（水平）。

line_props字典，可选

附加的线条属性。参见 Line2D。

useblitbool, 默认: True

是否使用位块传输（blitting）以加快绘图速度（如果后端支持）。详细信息请参阅教程 通过位块传输实现更快的渲染。

__init__(ax, positions, direction, *, line_props=None, useblit=True)

方法

__init__(ax, positions, direction, *[, ...])
closest(x, y)	返回最接近句柄的索引和像素距离。
remove()	从图中移除句柄 Artist 对象。
set_animated(value)	设置句柄 Artist 的动画状态。
set_data(positions)	设置句柄的 x 或 y 位置，具体取决于线条是垂直还是水平方向。
set_visible(value)	设置句柄 Artist 的可见性状态。

属性

艺术对象（artists）
direction	句柄的方向：'vertical' 或 'horizontal'。
positions（位置）	数据坐标系中句柄的位置。

property artists

closest(x, y)

返回最接近句柄的索引和像素距离。

参数:

x, yfloat

计算距离该 x, y 位置最近的句柄

返回:

index, distance句柄的索引及其与 x, y 位置的距离

位置 x, y

property direction

句柄的方向：'vertical' 或 'horizontal'。

property positions

数据坐标系中句柄的位置。

remove()

从图中移除句柄 Artist 对象。

set_animated(value)

设置句柄 Artist 的动画状态。

set_data(positions)

设置句柄的 x 或 y 位置，具体取决于线条是垂直还是水平方向。

参数:

positions长度为 2 的元组

设置数据坐标系中句柄的位置

set_visible(value)

设置句柄 Artist 的可见性状态。