小部件(widget)

小部件(widget)可与任何GUI后端一起工作。所有这些小部件都要求预定义一个Axes实例，并将其作为第一个参数传递。 Matplotlib不会试图布局这些小部件，所以，您必须自己决定Axes的宽度和高度，以便容纳这些小部件。

RangeSlider

RangeSlider的属性

• val，浮点元组

构造器

词法：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)

产生一个滑动条，这个滑动条代表浮点值范围。通过 (min, max) 的元组属性val，定义范围的最小值和最大值。

创建一个滑动条，定义包含在ax中的 [valmin, valmax] 的范围。为了使滑动条保持响应，必须维护对其的引用。调用 on_changed() 连接到滑块事件。

参数说明

• ax，该参数类型是Axes。RangeSlider将被放置到该Axes中。
• label，该参数类型是字符串。滑动条标签。
• valmin，该参数类型是float。滑动条的最小值。
• valmax，该参数类型是float。滑块的最大值。
• valinit，该参数类型是浮点元组或None, 默认值为None。滑动条的初始位置。如果是None，初始位置将位于范围的25%和75%。
• valfmt，该参数类型是字符串，默认值为None。%-格式字符串用于格式化滑动条的值。如果没有，则使用 ScalarFormatter。
• closemin，该参数类型是bool，默认值为True。滑块区间底部是否闭合。
• closemax，该参数类型是bool，默认值为True。滑块区间顶部是否封闭。
• dragging，该参数类型是bool，默认值为True。如果为True，则可以用鼠标拖滑动条。
• valstep，该参数类型是float，默认值为None。如果有一个给定值，则滑动条将捕捉到 valstep 的倍数。
• orientation，该参数类型是{‘horizontal’, ‘vertical’}，默认值为’horizontal’。滑动条的方向。
• track_color，该参数类型是color, 默认值为’lightgrey’。背景轨道的颜色。可以通过track属性访问该轨道，以进行进一步的样式设置。
• handle_style，该参数类型是dict

APIs

函数	说明
on_changed(func)	将 func 作为回调函数，连接到滑块值的更改。返回值是一个整数，它是连接id，可用于断开func
set_max(max)	将滑块的下限值设置为最大值。
set_min(min)	将滑块的下限值设置为最小值。
set_val(val)	将滑块值设置为 val。

应用实列

这个例子使用一个RangeSlider，去控制一个正弦波的频率。

import numpy as np
import matplotlib.pyplot as plt
from matplotlib.widgets import RangeSliderfreqs = np.arange(0.2, 2, 0.3)
fig, ax = plt.subplots()
ax.set_ylabel('Frequency', color='#00ff00')
ax.set_xlabel('Time', color='#0000ff')
ax.set_facecolor('#eafff5')
plt.subplots_adjust(left=0.15, bottom=0.1, right=0.9, top=0.9, wspace=0.2, hspace=0.2)plt.subplots_adjust(bottom=0.25)
t = np.arange(0.0, 10.0, 0.01)
s = np.sin(2*np.pi*freqs[0]*t)
l, = plt.plot(t, s, lw=2)def on_changed(val_list):l_val = val_list[0]h_val = val_list[1]i = (int)((h_val - l_val) % len(freqs))ydata = np.sin(2*np.pi*freqs[i]*t)l.set_ydata(ydata)l.set_color("#0000FF")plt.draw()if __name__ == "__main__":ax = plt.axes([0.2, 0.01, 0.60, 0.2])style = {"facecolor":"#8F0000", "edgecolor":"#00008F"}w_radio = RangeSlider(ax, "Slider", 0.0, len(freqs), track_color="#00FF00", handle_style=style,valinit=(1,100), valstep=0.5)w_radio.on_changed(on_changed)plt.show()

TextBox

TextBox的属性

• ax，参数类型是Axes。TextBox将在该Axes中显示。
• label，Text。
• color，参数类型是color。未悬停时文本框的颜色。
• hovercolor，参数类型是color。悬停时，文本框的颜色。

构造器

matplotlib.widgets.TextBox(ax, label, initial=‘’, color=‘.95’, hovercolor=‘1’, label_pad=0.01, textalignment=‘left’)

该构造器产生一个文本输入框。为了使文本框保持响应，您必须保留对它的引用。

每当文本更改时调用 on_text_change 进行更新。每当用户点击 Enter，或离开文本输入字段时，调用 on_submit 进行更新。

参数说明

• ax，该参数类型是Axes。TextBox将被放置到该Axes中
• label，该参数类型是字符串。此文本框的标签。
• initial，该参数类型是字符串。文本框中的初始值。
• color，该参数类型是color。文本框的颜色。
• hovercolor，该参数类型是color。当鼠标悬停在方框上时，该方框的颜色。
• label_pad，该参数类型是float。标签与文本框右侧之间的距离。
• textalignment，该参数类型是{‘left’, ‘center’, ‘right’}。指定文本的对齐方式。

APIs

函数	说明
disconnect(cid)	删除连接 ID 为 cid 的观察者。
on_submit(func)	当用户按下回车键或离开提交框时，使用事件调用此函数。返回一个连接 ID，可用于断开连接。
on_text_change(func)	当文本更改时，通过事件调用此函数。返回一个连接 ID，可用于断开连接。
position_cursor(x)
set_val(val)
stop_typing()

应用实列

该应用实列使用TextBox改变ylabel，在TextBox中显示的内容，被直接用作有label。3个Slider改变正弦波的显示颜色。

import numpy as np
import matplotlib.pyplot as plt
from matplotlib.widgets import Slider, TextBoxfreqs = np.arange(0.2, 2, 0.3)
fig, ax = plt.subplots()
ax.set_ylabel('Amplitue', color='#00ff00')
ax.set_xlabel('Time', color='#0000ff')
ax.set_facecolor('#eafff5')
plt.subplots_adjust(left=0.15, bottom=0.1, right=0.9, top=0.8, wspace=0.4, hspace=0.6)plt.subplots_adjust(bottom=0.45)
t = np.arange(0.0, 10.0, 0.01)
s = np.sin(2*np.pi*freqs[0]*t)
l, = plt.plot(t, s, lw=2)v_red = 0
v_green = 0
v_blue = 0def re_draw():global v_red, v_green, v_blues_red = hex(int(v_red))[2:]if len(s_red) < 2:s_red = '0' + s_reds_green = hex(int(v_green))[2:]if len(s_green) < 2:s_green = '0' + s_greens_blue = hex(int(v_blue))[2:]if len(s_blue) < 2:s_blue = '0' + s_bluecolor_s = "#{0}{1}{2}".format(s_red, s_green, s_blue)   l.set_color(color_s)plt.draw()def on_changed_red(val):global  v_redv_red = valre_draw()def on_changed_green(val):global v_greenv_green = valre_draw()def on_changed_blue(val):global v_bluev_blue = valre_draw()def on_ylabel_changed(s):ax.set_ylabel(s, color='#00ff00')plt.draw()def on_ylabel_submit(s):ax.set_ylabel(s, color='#ff0000')plt.draw()if __name__ == "__main__":text_ax_1 = plt.axes([0.2, 0.82, 0.60, 0.08])style_1 = {"facecolor":"#8F0000", "edgecolor":"#00008F"}w_text = TextBox(text_ax_1, "ylabel")w_text.on_text_change(on_ylabel_changed)w_text.on_submit(on_ylabel_submit)slider_ax_1 = plt.axes([0.2, 0.20, 0.60, 0.1])style_1 = {"facecolor":"#8F0000", "edgecolor":"#00008F"}w_silder_1 = Slider(slider_ax_1, "Red", 0.0, 255, track_color="#FF0000", handle_style=style_1, valstep=1.0)w_silder_1.on_changed(on_changed_red)slider_ax_2 = plt.axes([0.2, 0.13, 0.60, 0.1])style_2 = {"facecolor":"#008F00", "edgecolor":"#00008F"}w_silder_2 = Slider(slider_ax_2, "Green", 0.0, 255, track_color="#00FF00", handle_style=style_2, valstep=1.0)w_silder_2.on_changed(on_changed_green)slider_ax_3 = plt.axes([0.2, 0.06, 0.60, 0.1])style = {"facecolor":"#8F0000", "edgecolor":"#00008F"}w_silder_3 = Slider(slider_ax_3, "Blue", 0.0, 255, track_color="#0000FF", handle_style=style, valstep=1.0)w_silder_3.on_changed(on_changed_blue)plt.show()