matplotlib.widgets._SelectorWidget#

class matplotlib.widgets._SelectorWidget(ax, onselect=None, useblit=False, button=None, state_modifier_keys=None, use_data_coordinates=False)[源代码]#

基类: AxesWidget

选择器组件的基类。

此类为选择器组件提供常用功能,例如处理鼠标和键盘事件、管理状态修改键等。

该类本身是私有的,可能会在没有预先通知的情况下进行更改或删除。但是,它为子类提供的公共 API 是稳定的,并在子类中被视为公共 API。

add_state(state)[源代码]#

添加一个状态以定义组件的行为。有关详细信息,请参阅具体选择器类构造函数中的 state_modifier_keys 参数。

参数:
statestr

必须是选择器支持的状态。有关详细信息,请参阅具体选择器类构造函数中的 state_modifier_keys 参数。

引发:
ValueError

当选择器不支持该状态时引发。

property artists#

选择器图元(artists)的元组。

clear()[源代码]#

清除选择并使选择器准备好进行新的选择。

connect_default_events()[源代码]#

将主要的画布事件连接到方法。

get_visible()[源代码]#

获取选择器图元的可见性。

ignore(event)[源代码]#

返回是否应忽略该 event

此方法应在任何事件回调的开头调用。

on_key_press(event)[源代码]#

所有选择组件的按键事件处理程序和验证器。

on_key_release(event)[源代码]#

按键释放事件处理程序和验证器。

on_scroll(event)[源代码]#

鼠标滚动事件处理程序和验证器。

onmove(event)[源代码]#

光标移动事件处理程序和验证器。

press(event)[源代码]#

按钮按下处理程序和验证器。

release(event)[源代码]#

按钮释放事件处理程序和验证器。

remove_state(state)[源代码]#

移除一个状态以定义组件的行为。有关详细信息,请参阅具体选择器类构造函数中的 state_modifier_keys 参数。

参数:
statestr

必须是选择器支持的状态。有关详细信息,请参阅具体选择器类构造函数中的 state_modifier_keys 参数。

引发:
ValueError

当选择器不支持该状态时引发。

set_active(active)[源代码]#

设置组件是否处于活动状态。

set_handle_props(**handle_props)[源代码]#

设置手柄选择器图元的属性。请参阅选择器文档字符串中的 handle_props 参数以了解支持哪些属性。

set_props(**props)[源代码]#

设置选择器图元的属性。

请参阅选择器文档字符串中的 props 参数以了解支持哪些属性。

set_visible(visible)[源代码]#

设置选择器图元的可见性。

update()[源代码]#

使用 blit() 或 draw_idle() 进行绘制,具体取决于 self.useblit

update_background(event)[源代码]#

强制更新背景。

property useblit#

返回是否使用了 blitting(即画布请求并支持该功能)。

使用 matplotlib.widgets._SelectorWidget 的示例#

使用多边形选择器从集合中选择索引

使用多边形选择器从集合中选择索引

多边形选择器

多边形选择器

矩形和椭圆选择器

矩形和椭圆选择器

跨度选择器

跨度选择器