matplotlib.artist.Artist.set_picker#
- Artist.set_picker(picker)[源代码][源代码]#
定义艺术家的选取行为。
- 参数:
- 选择器None 或 bool 或 float 或 callable
这可以是以下之一:
None: 此艺术家的选择功能被禁用(默认)。
一个布尔值:如果为 True,则启用拾取功能,如果鼠标事件在艺术家上方,艺术家将触发拾取事件。
一个浮点数:如果 picker 是一个数字,它被解释为以点为单位的 epsilon 容差,并且如果其数据在鼠标事件的 epsilon 范围内,艺术家将触发一个事件。对于某些艺术家,如线条和补丁集合,艺术家可能会为生成的拾取事件提供额外的数据,例如,在拾取事件的 epsilon 范围内的数据的索引。
一个函数:如果 picker 是可调用的,它是一个用户提供的函数,用于确定艺术家是否被鼠标事件击中:
hit, props = picker(artist, mouseevent)
确定命中测试。如果鼠标事件在艺术家上方,返回 hit=True 并且 props 是一个你希望添加到 PickEvent 属性的属性字典。