matplotlib.widgets.EllipseSelector#
- class matplotlib.widgets.EllipseSelector(ax, onselect=None, *, minspanx=0, minspany=0, useblit=False, props=None, spancoords='data', button=None, grab_range=10, handle_props=None, interactive=False, state_modifier_keys=None, drag_from_anywhere=False, ignore_event_outside=False, use_data_coordinates=False)[source]#
-
选择坐标轴上的椭圆区域。
为了使光标保持响应，您必须保留对它的引用。
在选择区域外同一坐标处触发的按下和释放事件将清除选择器，除非设置了
ignore_event_outside=True。- 参数:
- ax
Axes 组件的父级 Axes 对象。
- onselect函数，可选
一个回调函数，在释放事件后以及创建、更改或删除选择区域时被调用。它必须具有以下签名：
def onselect(eclick: MouseEvent, erelease: MouseEvent)
其中 eclick 和 erelease 分别是开始和完成选择的鼠标点击和释放
MouseEvent事件。- minspanxfloat, 默认值: 0
x 跨度小于或等于 minspanx 的选择将被移除（如果已存在）或取消。
- minspanyfloat, 默认值: 0
y 跨度小于或等于 minspanx 的选择将被移除（如果已存在）或取消。
- useblitbool, 默认值: False
是否使用位块传输（blitting）以加快绘图速度（如果后端支持）。详细信息请参阅教程 通过位块传输实现更快的渲染。
- props字典，可选
绘制椭圆时使用的属性。有关有效属性，请参阅
Patch。默认值dict(facecolor='red', edgecolor='black', alpha=0.2, fill=True)- spancoords{"data", "pixels"}, 默认值: "data"
是将 minspanx 和 minspany 解释为数据坐标还是像素坐标。
- button
MouseButton,MouseButton列表, 默认值: 所有按钮 触发矩形选择的按钮。
- grab_rangefloat, 默认值: 10
激活交互工具句柄的像素距离。
- handle_propsdict, 可选
绘制交互句柄（标记艺术家）时使用的属性。有关有效属性，请参阅
Line2D中的标记参数。默认值在mpl.rcParams中定义，但markeredgecolor的默认值除外，它将与 props 中的edgecolor属性相同。- interactivebool, 默认值: False
是否绘制一组允许在绘制后与小部件进行交互的句柄。
- state_modifier_keysdict, 可选
影响小部件行为的键盘修饰键。值会修改默认设置，默认设置为：
"move": 移动现有形状，默认值: 无修饰键。
"clear": 清除当前形状，默认值: "escape"。
"square": 将形状变为正方形，默认值: "shift"。
"center": 围绕中心更改形状，默认值: "ctrl"。
"rotate": 在 -45° 和 45° 之间围绕中心旋转形状，默认值: "r"。
"square" 和 "center" 可以组合使用。正方形的形状可以根据创建选择器时指定的
use_data_coordinates参数，定义在数据坐标或显示坐标中。- drag_from_anywherebool, 默认值: False
如果为
True，则可以通过在其边界内的任何位置点击来移动小部件。- ignore_event_outsidebool, 默认值: False
如果为
True，则会忽略在跨度选择器外触发的事件。- use_data_coordinatesbool, 默认值: False
如果为
True，则选择器的“正方形”形状定义在数据坐标中，而不是显示坐标中。
- ax
示例
