matplotlib.artist.Artist.set_picker#

Artist.set_picker(picker)[源]#

定义艺术家的选择行为。

参数:
pickerNone、布尔值、浮点数或可调用对象

可以是以下值之一:

  • None:为此艺术家禁用拾取功能(默认)。

  • 布尔值:如果为 True,则启用拾取功能,如果鼠标事件在艺术家上方,则艺术家将触发拾取事件。

  • 浮点数:如果 picker 是一个数字,它将被解释为点内的 epsilon 容差,如果其数据在鼠标事件的 epsilon 范围内,则艺术家将触发一个事件。对于某些艺术家(如线条和补丁集合),艺术家可能会向生成的拾取事件提供额外数据,例如,拾取事件的 epsilon 范围内的数据索引。

  • 函数:如果 picker 是可调用对象,它是一个用户提供的函数,用于确定艺术家是否被鼠标事件命中。

    hit, props = picker(artist, mouseevent)
    

    以确定命中测试。如果鼠标事件在艺术家上方,返回 hit=True,并且 props 是一个字典,包含您希望添加到 PickEvent 属性中的属性。

使用 matplotlib.artist.Artist.set_picker 的示例#

图例选择

图例选择

选择事件演示

选择事件演示