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文档。