matplotlib.widgets.RangeSlider#

class matplotlib.widgets.RangeSlider(ax, label, valmin, valmax, *, valinit=None, valfmt=None, closedmin=True, closedmax=True, dragging=True, valstep=None, orientation='horizontal', track_color='lightgrey', handle_style=None, **kwargs)[source]#

基类: SliderBase

用于表示浮点值范围的滑块。通过 val 属性定义范围的最小值和最大值,以 (min, max) 元组形式表示。

在坐标轴 ax 中创建一个定义 [valmin, valmax] 范围内值的滑块。为了保持滑块的响应性,您必须保留对它的引用。调用 on_changed() 以连接到滑块事件。

属性:
val浮点数元组

滑块的值。

参数:
axAxes(坐标轴)

放置滑块的坐标轴。

labelstr

滑块标签。

valminfloat

滑块的最小值。

valmaxfloat

滑块的最大值。

valinit浮点数元组或 None,默认值:None

滑块的初始位置。如果为 None,则初始位置将位于该范围的第 25% 和第 75% 百分位。

valfmtstr 或可调用对象,默认值:None

格式化范围最小值和最大值的方式。如果是字符串,则必须采用 % 格式。如果是可调用对象,则必须具有 valfmt(val: float) -> str 的签名。如果为 None,则使用 ScalarFormatter

closedminbool,默认值:True

滑块区间在底部是否闭合。

closedmaxbool,默认值:True

滑块区间在顶部是否闭合。

draggingbool,默认值:True

如果为 True,则滑块可以用鼠标拖动。

valstepfloat,默认值:None

如果提供,滑块将吸附到 valstep 的倍数上。

orientation{'horizontal', 'vertical'},默认值: 'horizontal'

滑块的方向。

track_colorcolor(颜色),默认值:'lightgrey'

背景轨道的颜色。可通过 track 属性对轨道进行进一步样式设置。

handle_styledict

滑块手柄的属性。默认值为:

默认值

描述

facecolor

color

'white'

滑块手柄的填充颜色。

edgecolor

color

'.75'

滑块手柄的边框颜色。

size

int

10

滑块手柄的大小(点)。

其他值将被转换为 marker{foo} 并传递给 Line2D 构造函数。例如 handle_style = {'style'='x'} 将导致 markerstyle = 'x'

备注

额外的 kwargs 会传递给 self.poly,即绘制滑块旋钮的 Polygon。有关有效属性名称(facecolor, edgecolor, alpha 等),请参阅 Polygon 文档。

on_changed(func)[source]#

func 连接为滑块值更改时的回调函数。

参数:
funccallable

滑块更改时调用的函数。该函数必须接受一个包含两个浮点数的元组作为参数。

返回:
int

连接 ID(可用于断开 func 的连接)。

set_max(max)[source]#

将滑块的上限值设置为 max

参数:
maxfloat
set_min(min)[source]#

将滑块的下限值设置为 min

参数:
minfloat
set_val(val)[source]#

将滑块的值设置为 val

参数:
val元组或类数组浮点数

使用 matplotlib.widgets.RangeSlider 的示例#

使用 RangeSlider 进行图像缩放

使用 RangeSlider 进行图像缩放