matplotlib.widgets
Элементы управления, не зависящие от графической оболочки
Элементы управления, разработанные для работы с любыми графическими оболочками. Все эти элементы управления требуют предварительного определения экземпляра matplotlib.axes.Axes и передачи его в качестве первого параметра. Matplotlib не пытается быть слишком умным в отношении макета — вам придется определить, какой ширины и высоты вы хотите, чтобы были ваши оси, чтобы разместить ваш элемент управления.
-
class matplotlib.widgets.AxesWidget(ax)[source] -
Bases:
matplotlib.widgets.WidgetЭлемент управления, связанный с одной
Axes.Чтобы гарантировать, что элемент управления остаётся отзывчивым и не удаляется из памяти, пользователь должен сохранить ссылку на объект.
Это необходимо, потому что регистр обратных вызовов сохраняет только слабые ссылки на функции, которые являются методами элемента управления. Если на объект элемента управления нет ссылок, он может быть удалён из памяти, что разорвёт обратные вызовы.
Атрибуты: -
axAxes -
Родительские оси для элемента управления.
-
canvasFigureCanvasBase -
Родительский холст фигуры для элемента управления.
-
activebool -
Активен ли элемент управления?
-
connect_event(self, event, callback)[source] -
Подключение обратного вызова к событию.
Это следует использовать вместо
figure.canvas.mpl_connect, так как эта функция сохраняет идентификаторы обратных вызовов для последующей очистки.
-
disconnect_events(self)[source] -
Отключение всех событий, созданных этим элементом управления.
-
-
class matplotlib.widgets.Button(ax, label, image=None, color='0.85', hovercolor='0.95')[source] -
Bases:
matplotlib.widgets.AxesWidgetКнопка, не зависящая от графической оболочки.
Для того, чтобы кнопка оставалась отзывчивой, необходимо сохранить ссылку на неё. Для подключения к кнопке вызовите
on_clicked.Атрибуты: - ax
-
Оси
matplotlib.axes.Axes, в которые отрисовывается кнопка. - label
-
Экземпляр
matplotlib.text.Text. - color
-
Цвет кнопки, когда она не наведена.
- hovercolor
-
Цвет кнопки, когда на неё наведена мышь.
Параметры: -
axAxes -
Экземпляр осей
Axes, в которые будет помещена кнопка. -
labelstr -
Текст кнопки.
-
imagearray-like or PIL Image -
Изображение, которое нужно поместить в кнопку, если оно не None. Параметр напрямую передаётся в
imshow. -
colorcolor -
Цвет кнопки, когда она не активна.
-
hovercolorcolor -
Цвет кнопки, когда курсор находится над ней.
-
disconnect(self, cid)[source] -
Удаление функции обратного вызова с идентификатором соединения cid.
-
on_clicked(self, func)[source] -
Подключение функции обратного вызова func к событиям нажатия на кнопку.
Возвращает идентификатор соединения, который можно использовать для отключения обратного вызова.
-
class matplotlib.widgets.CheckButtons(ax, labels, actives=None)[source] -
Bases:
matplotlib.widgets.AxesWidgetНабор флажков, не зависящий от графического интерфейса.
Для того, чтобы флажки оставались отзывчивыми, необходимо сохранить ссылку на этот объект.
Подключитесь к CheckButtons с помощью метода
on_clicked.Атрибуты: -
axAxes -
Родительские оси виджета.
-
labelslist of Text -
rectangleslist of Rectangle -
lineslist of (Line2D, Line2D) pairs -
Список линий для знаков «x» в флажках. Эти линии существуют для каждого поля, но имеют
set_visible(False)когда его поле не выбрано.
Добавьте флажки на экземпляр
matplotlib.axes.AxesaxПараметры: -
axAxes -
Родительские оси виджета.
-
labelslist of str -
Метки флажков.
-
activeslist of bool, optional -
Начальное состояние выбора кнопок. Список должен иметь такую же длину, как и labels. Если не указано, все кнопки не выбраны.
-
disconnect(self, cid)[source] -
Удалить наблюдателя с идентификатором подключения cid.
-
get_status(self)[source] -
Возвращает кортеж состояния (True/False) всех флажков.
-
on_clicked(self, func)[source] -
Подключить функцию обратного вызова func к событиям щелчка по кнопке.
Возвращает идентификатор подключения, который можно использовать для отключения обратного вызова.
-
set_active(self, index)[source] -
Переключать (активировать или деактивировать) флажок по индексу.
Обратные вызовы будут вызваны, если
eventsonравно True.Параметры: -
indexint -
Индекс флажка для переключения.
Исключения: - ValueError
-
Если index неверно.
-
-
-
class matplotlib.widgets.Cursor(ax, horizOn=True, vertOn=True, useblit=False, **lineprops)[source] -
Bases:
matplotlib.widgets.AxesWidgetПерекрестный курсор, который охватывает оси и перемещается вместе с курсором мыши.
Для того, чтобы курсор оставался отзывчивым, необходимо сохранить ссылку на него.
Параметры: -
axmatplotlib.axes.Axes -
Оси
Axesдля прикрепления курсора. -
horizOnbool, default: True -
Рисовать линию по горизонтали.
-
vertOnbool, default: True -
Рисовать линию по вертикали.
-
useblitbool, default: False -
Использовать blitting для более быстрого отрисовки, если это поддерживается бэкендом.
Другие параметры: Примеры
См. Курсор.
-
clear(self, event)[source] -
Внутренний обработчик событий для очистки курсора.
-
onmove(self, event)[source] -
Внутренний обработчик событий для отрисовки курсора при перемещении мыши.
-
-
class matplotlib.widgets.EllipseSelector(ax, onselect, drawtype='box', minspanx=0, minspany=0, useblit=False, lineprops=None, rectprops=None, spancoords='data', button=None, maxdist=10, marker_props=None, interactive=False, state_modifier_keys=None)[source] -
Bases:
matplotlib.widgets.RectangleSelectorВыбрать эллиптическую область осей.
Для того, чтобы курсор оставался отзывчивым, необходимо сохранить ссылку на него.
Пример использования:
import numpy as np import matplotlib.pyplot as plt from matplotlib.widgets import EllipseSelector def onselect(eclick, erelease): "eclick and erelease are matplotlib events at press and release." print('startposition: (%f, %f)' % (eclick.xdata, eclick.ydata)) print('endposition : (%f, %f)' % (erelease.xdata, erelease.ydata)) print('used button : ', eclick.button) def toggle_selector(event): print(' Key pressed.') if event.key in ['Q', 'q'] and toggle_selector.ES.active: print('EllipseSelector deactivated.') toggle_selector.RS.set_active(False) if event.key in ['A', 'a'] and not toggle_selector.ES.active: print('EllipseSelector activated.') toggle_selector.ES.set_active(True) x = np.arange(100.) / 99 y = np.sin(x) fig, ax = plt.subplots() ax.plot(x, y) toggle_selector.ES = EllipseSelector(ax, onselect, drawtype='line') fig.canvas.mpl_connect('key_press_event', toggle_selector) plt.show()Параметры: -
axAxes -
Родительские оси виджета.
-
onselectfunction -
Функция обратного вызова, которая вызывается после завершения выбора. Она должна иметь сигнатуру:
def onselect(eclick: MouseEvent, erelease: MouseEvent)
где eclick и erelease — события щелчка мышью и отпускания
MouseEvent, которые начинаются и завершают выбор. -
drawtype{"box", "line", "none"}, default: "box" -
Рисовать полную прямоугольную рамку, диагональную линию прямоугольника или ничего.
-
minspanxfloat, default: 0 -
Выборы с шириной по x менее minspanx игнорируются.
-
minspanyfloat, default: 0 -
Выборы с шириной по y менее minspany игнорируются.
-
useblitbool, default: False -
Использовать blitting для более быстрого отрисовки (если поддерживается бэкендом).
-
linepropsdict, optional -
Свойства, с помощью которых линия рисуется, если
drawtype == "line". По умолчанию:dict(color="black", linestyle="-", linewidth=2, alpha=0.5)
-
rectpropsdict, optional -
Свойства, с помощью которых рисуется прямоугольник, если
drawtype == "box". По умолчанию:dict(facecolor="red", edgecolor="black", alpha=0.2, fill=True)
-
spancoords{"data", "pixels"}, default: "data" -
Интерпретировать minspanx и minspany в координатах данных или пикселей.
-
buttonMouseButton, list of MouseButton, default: all buttons -
Кнопка(ы), которые запускают прямоугольный выбор.
-
maxdistfloat, default: 10 -
Расстояние в пикселях, в пределах которого можно активировать интерактивные инструменты.
-
marker_propsdict -
Свойства, с помощью которых рисуются интерактивные маркеры. В настоящее время не реализовано и игнорируется.
-
interactivebool, default: False -
Рисовать набор маркеров, которые позволяют взаимодействовать с виджетом после его отрисовки.
-
state_modifier_keysdict, optional -
Модификаторы клавиатуры, которые влияют на поведение виджета. Значения изменяют значения по умолчанию.
- "move": Перемещение существующей формы, по умолчанию: без модификатора.
- "clear": Очистка текущей формы, по умолчанию: "escape".
- "square": Делает форму квадратной, по умолчанию: "shift".
- "center": Делает начальную точку центром формы, по умолчанию: "ctrl".
"square" и "center" могут быть объединены.
-
draw_shape(self, extents)[source]
-
-
class matplotlib.widgets.Lasso(ax, xy, callback=None, useblit=True)[source] -
Bases:
matplotlib.widgets.AxesWidgetКривая выделения произвольной формы.
Выбранный путь можно использовать совместно с
contains_pointдля выделения точек данных из изображения.В отличие от
LassoSelector, этот объект должен быть инициализирован начальной точкой xy, и событияLassoуничтожаются при отпускании.Параметры: -
axAxes -
Оси родителя виджета.
-
xy(float, float) -
Координаты начала лассо.
-
callbackcallable -
Когда лассо отпускается, функция callback вызывается и получает вершины выбранного пути.
-
onmove(self, event)[source]
-
onrelease(self, event)[source]
-
-
class matplotlib.widgets.LassoSelector(ax, onselect=None, useblit=True, lineprops=None, button=None)[source] -
Bases:
matplotlib.widgets._SelectorWidgetКривая выделения произвольной формы.
Чтобы селектор оставался отзывчивым, вы должны сохранить на него ссылку.
Выбранный путь можно использовать совместно с
contains_pointдля выделения точек данных из изображения.В отличие от
Lasso,LassoSelectorнаписан с интерфейсом, аналогичнымRectangleSelectorиSpanSelector, и будет продолжать взаимодействовать с осями до отключения.Пример использования:
ax = subplot(111) ax.plot(x, y) def onselect(verts): print(verts) lasso = LassoSelector(ax, onselect)Параметры: -
axAxes -
Оси родителя виджета.
-
onselectfunction -
При отпускании лассо вызывается функция onselect и получает вершины выделенного пути.
-
buttonMouseButton or list of MouseButton, optional -
Кнопки мыши, используемые для прямоугольного выделения. По умолчанию
None, что соответствует всем кнопкам.
-
onpress(self, event)[source]
-
onrelease(self, event)[source]
-
-
class matplotlib.widgets.LockDraw[source] -
Bases:
objectНекоторые виджеты, такие как курсор, рисуют на холсте, и это нежелательно во всех случаях, например, когда панель инструментов находится в режиме масштабирования по прямоугольнику и рисует прямоугольник. Чтобы избежать этого, виджет может получить блокировку холста с помощью
canvas.widgetlock(widget)перед рисованием на холсте; это предотвратит рисование другими виджетами в то же время (если они также попытаются получить блокировку первыми).-
available(self, o)[source] -
Возвращает, доступно ли рисование для o.
-
isowner(self, o)[source] -
Возвращает, владеет ли o этой блокировкой.
-
locked(self)[source] -
Возвращает, заблокирован ли холст в данный момент.
-
release(self, o)[source] -
Освободить блокировку от o.
-
-
class matplotlib.widgets.MultiCursor(canvas, axes, useblit=True, horizOn=False, vertOn=True, **lineprops)[source] -
Bases:
matplotlib.widgets.WidgetОбеспечивает вертикальный (по умолчанию) и/или горизонтальный курсор, общий для нескольких осей.
Чтобы курсор оставался отзывчивым, вы должны сохранить на него ссылку.
Пример использования:
from matplotlib.widgets import MultiCursor import matplotlib.pyplot as plt import numpy as np fig, (ax1, ax2) = plt.subplots(nrows=2, sharex=True) t = np.arange(0.0, 2.0, 0.01) ax1.plot(t, np.sin(2*np.pi*t)) ax2.plot(t, np.sin(4*np.pi*t)) multi = MultiCursor(fig.canvas, (ax1, ax2), color='r', lw=1, horizOn=False, vertOn=True) plt.show()-
clear(self, event)[source] -
Очистить курсор.
-
connect(self)[source] -
Подключить события.
-
disconnect(self)[source] -
Отключить события.
-
onmove(self, event)[source]
-
-
class matplotlib.widgets.PolygonSelector(ax, onselect, useblit=False, lineprops=None, markerprops=None, vertex_select_radius=15)[source] -
Bases:
matplotlib.widgets._SelectorWidgetВыделение области многоугольника на осях.
Укажите вершины с помощью каждого щелчка мыши, и сделайте выбор, завершив многоугольник (щелкнув по первой вершине). Зажмите клавишу ctrl и щелкните и перетащите вершину, чтобы переместить ее (клавиша ctrl не требуется, если многоугольник уже завершен). Зажмите клавишу shift и щелкните и перетащите в любом месте осей, чтобы переместить все вершины. Нажмите клавишу esc, чтобы начать новый многоугольник.
Чтобы селектор оставался отзывчивым, вы должны сохранить на него ссылку.
Параметры: -
axAxes -
Оси родителя виджета.
-
onselectfunction -
При завершении или модификации многоугольника после завершения вызывается функция onselect и получает список вершин в виде кортежей
(xdata, ydata). -
useblitbool, default: False -
linepropsdict, default: dict(color='k', linestyle='-', linewidth=2, alpha=0.5). -
Свойства объекта для линии, представляющей края многоугольника.
-
markerpropsdict, default: dict(marker='o', markersize=7, mec='k', mfc='k', alpha=0.5). -
Свойства объекта для маркеров, нарисованных в вершинах многоугольника.
-
vertex_select_radiusfloat, default: 15px -
Вершина выделяется (для завершения многоугольника или перемещения вершины), если щелчок мыши находится в пределах vertex_select_radius пикселей от вершины.
Примеры
Демонстрация селектора многоугольника
-
onmove(self, event)[source] -
Обработчик событий перемещения курсора и валидатор
-
property verts -
Вершины многоугольника, как список пар
(x, y).
-
-
class matplotlib.widgets.RadioButtons(ax, labels, active=0, activecolor='blue')[source] -
Bases:
matplotlib.widgets.AxesWidgetРадиокнопка, не зависящая от конкретной графической среды.
Для сохранения отзывчивости кнопок необходимо сохранить ссылку на этот объект.
Подключите обработчик событий к RadioButtons с помощью метода
on_clicked.Атрибуты: -
axAxes -
Родительские оси виджета.
-
activecolorcolor -
Цвет выбранной кнопки.
-
labelslist of Text -
Подписи кнопок.
-
circleslist of Circle -
Кнопки.
-
value_selectedstr -
Текст метки текущей выбранной кнопки.
Добавьте радиокнопки к
Axes.Параметры: -
axAxes -
Оси, к которым нужно добавить кнопки.
-
labelslist of str -
Метки кнопок.
-
activeint -
Индекс выбранной по умолчанию кнопки.
-
activecolorcolor -
Цвет выделенной кнопки.
-
disconnect(self, cid)[source] -
Удаляет наблюдателя с идентификатором подключения cid.
-
on_clicked(self, func)[source] -
Подключает функцию обратного вызова func к событиям нажатия на кнопку.
Возвращает идентификатор подключения, который может быть использован для отключения обратного вызова.
-
set_active(self, index)[source] -
Выбирает кнопку с номером index.
Обратные вызовы будут вызваны, если
eventsonравно True.
-
-
class matplotlib.widgets.RectangleSelector(ax, onselect, drawtype='box', minspanx=0, minspany=0, useblit=False, lineprops=None, rectprops=None, spancoords='data', button=None, maxdist=10, marker_props=None, interactive=False, state_modifier_keys=None)[source] -
Bases:
matplotlib.widgets._SelectorWidgetВыделяет прямоугольную область на осях.
Для сохранения отзывчивости курсора необходимо сохранить ссылку на него.
Примеры
Параметры: -
axAxes -
Родительские оси виджета.
-
onselectfunction -
Функция обратного вызова, которая вызывается после завершения выбора. Она должна иметь сигнатуру:
def onselect(eclick: MouseEvent, erelease: MouseEvent)
где eclick и erelease — события нажатия и отпускания мыши, начинающие и завершающие выбор.
-
drawtype{"box", "line", "none"}, default: "box" -
Отображать ли полную прямоугольную рамку, диагональную линию прямоугольника или ничего.
-
minspanxfloat, default: 0 -
Выбор с шириной менее minspanx игнорируется.
-
minspanyfloat, default: 0 -
Выборы с высотой менее minspany игнорируются.
-
useblitbool, default: False -
Использовать ли кеширование для ускорения отрисовки (если поддерживается бэкендом).
-
linepropsdict, optional -
Свойства, с помощью которых рисуется линия, если
drawtype == "line". По умолчанию:dict(color="black", linestyle="-", linewidth=2, alpha=0.5)
-
rectpropsdict, optional -
Свойства, с помощью которых рисуется прямоугольник, если
drawtype == "box". По умолчанию:dict(color="black", linestyle="-", linewidth=2, alpha=0.5)
-
spancoords{"data", "pixels"}, default: "data" -
Интерпретировать minspanx и minspany в координатах данных или пикселей.
-
buttonMouseButton, list of MouseButton, default: all buttons -
Кнопки, которые вызывают выбор прямоугольника.
-
maxdistfloat, default: 10 -
Расстояние в пикселях, в пределах которого может быть активирован интерактивный инструмент.
-
marker_propsdict -
Свойства, с помощью которых рисуются интерактивные маркеры. В настоящее время не реализовано и игнорируется.
-
interactivebool, default: False -
Рисовать ли набор маркеров, позволяющих взаимодействовать с виджетом после его отрисовки.
-
state_modifier_keysdict, optional -
Комбинации клавиш, которые влияют на поведение виджета. Значения изменяют значения по умолчанию.
- "move": Переместить существующую фигуру, по умолчанию: без модификаторов.
- "clear": Очистить текущую фигуру, по умолчанию: "Esc".
- "square": Сделать фигуру квадратной, по умолчанию: "Shift".
- "center": Сделать начальную точку центром фигуры, по умолчанию: "Ctrl".
"square" и "center" могут использоваться совместно.
-
property center -
Центр прямоугольника
-
property corners -
Углы прямоугольника, начиная с нижнего левого, по часовой стрелке.
-
draw_shape(self, extents)[source]
-
property edge_centers -
Середины сторон прямоугольника, начиная с левой, по часовой стрелке.
-
property extents -
Возвращает (xmin, xmax, ymin, ymax).
-
property geometry -
Возвращает массив формы (2, 5), содержащий координаты x (
RectangleSelector.geometry[1, :]) и y (RectangleSelector.geometry[0, :]) четырёх углов прямоугольника, начиная с верхнего левого угла и двигаясь по часовой стрелке.
-
-
class matplotlib.widgets.Slider(ax, label, valmin, valmax, valinit=0.5, valfmt=None, closedmin=True, closedmax=True, slidermin=None, slidermax=None, dragging=True, valstep=None, orientation='horizontal', **kwargs)[source] -
Базовый класс:
matplotlib.widgets.AxesWidgetПолзунок, представляющий числовой диапазон.
Создаёт ползунок от valmin до valmax на осях ax. Для обеспечения отзывчивости ползунка необходимо сохранить ссылку на него. Для подключения к событию перемещения ползунка вызовите
on_changed().Атрибуты: -
valfloat -
Значение ползунка.
Параметры: -
axAxes -
Оси, на которых отображается ползунок.
-
labelstr -
Метка ползунка.
-
valminfloat -
Минимальное значение ползунка.
-
valmaxfloat -
Максимальное значение ползунка.
-
valinitfloat, default: 0.5 -
Начальное положение ползунка.
-
valfmtstr, default: None -
Строка формата, используемая для форматирования значения ползунка. Если None, используется
ScalarFormatter. -
closedminbool, default: True -
Закрыт ли интервал ползунка слева.
-
closedmaxbool, default: True -
Закрыт ли интервал ползунка справа.
-
sliderminSlider, default: None -
Запретить ползунку принимать значение меньше, чем значение slidermin.
-
slidermaxSlider, default: None -
Запретить ползунку принимать значение больше, чем значение slidermax.
-
draggingbool, default: True -
Если True, ползунок можно перетаскивать мышкой.
-
valstepfloat, default: None -
Если указано, ползунок будет перемещаться с шагом valstep.
-
orientation{'horizontal', 'vertical'}, default: 'horizontal' -
Ориентация ползунка.
Примечания
Дополнительные ключевые параметры передаются
self.poly, который являетсяRectangleрисующим ползунок. См. документациюRectangleдля допустимых свойств (facecolor,edgecolor,alpha, и т.д.).-
disconnect(self, cid)[source] -
Удаляет наблюдателя с идентификатором соединения cid
Параметры: -
cidint -
Идентификатор соединения наблюдателя, который нужно удалить
-
-
on_changed(self, func)[source] -
При изменении значения ползунка вызывается func с новым значением ползунка
Параметры: -
funccallable -
Функция, вызываемая при изменении ползунка. Функция должна принимать одно значение с плавающей точкой как аргумент.
Возвращает: - int
-
Идентификатор соединения (который может быть использован для отключения func)
-
-
reset(self)[source] -
Сброс ползунка до начального значения
-
set_val(self, val)[source] -
Установить значение ползунка на val
Параметры: -
valfloat
-
-
-
class matplotlib.widgets.SpanSelector(ax, onselect, direction, minspan=None, useblit=False, rectprops=None, onmove_callback=None, span_stays=False, button=None)[source] -
Базовый класс:
matplotlib.widgets._SelectorWidgetВизуально выбирает диапазон мин/макс на одной оси и вызывает функцию с этими значениями.
Для обеспечения отзывчивости селектора, сохраните ссылку на него.
Для отключения SpanSelector установите
span_selector.activeв False. Чтобы включить его обратно, установите в True.Параметры: -
axmatplotlib.axes.Axes -
onselectfunc(min, max), min/max are floats -
direction{"horizontal", "vertical"} -
Направление выбора области.
-
minspanfloat, default: None -
Если выбор меньше, чем minspan, не вызывать onselect.
-
useblitbool, default: False -
Если True, используется функция ускорения отрисовки, зависящая от бэкэнда.
-
rectpropsdict, default: None -
Словарь свойств
matplotlib.patches.Patch. -
onmove_callbackfunc(min, max), min/max are floats, default: None -
Вызывается при перемещении мыши во время выбора диапазона.
-
span_staysbool, default: False -
Если True, область остается видимой после отпускания мыши.
-
buttonMouseButton or list of MouseButton -
Кнопки мыши, которые активируют SpanSelector.
Примеры
>>> import matplotlib.pyplot as plt >>> import matplotlib.widgets as mwidgets >>> fig, ax = plt.subplots() >>> ax.plot([1, 2, 3], [10, 50, 100]) >>> def onselect(vmin, vmax): ... print(vmin, vmax) >>> rectprops = dict(facecolor='blue', alpha=0.5) >>> span = mwidgets.SpanSelector(ax, onselect, 'horizontal', ... rectprops=rectprops) >>> fig.show()
См. также: Span Selector
-
ignore(self, event)[source] -
Возвращает, нужно ли игнорировать event.
Этот метод следует вызывать в начале любого обработчика событий.
-
new_axes(self, ax)[source] -
Устанавливает SpanSelector для работы с новыми осями.
-
-
class matplotlib.widgets.SubplotTool(targetfig, toolfig)[source] -
Bases:
matplotlib.widgets.WidgetИнструмент для настройки параметров подграфика
matplotlib.figure.Figure.Параметры: -
targetfigFigure -
Экземпляр фигуры для настройки.
-
toolfigFigure -
Экземпляр фигуры, в которую будет вставлен инструмент подграфика.
-
property axbottom
-
property axhspace
-
property axleft
-
property axright
-
property axtop
-
property axwspace
-
funcbottom(self, val)[source] -
[Устарело]
Примечания
Устарело начиная с версии 3.3:
-
funchspace(self, val)[source] -
[Устарело]
Примечания
Устарело начиная с версии 3.3:
-
funcleft(self, val)[source] -
[Устарело]
Примечания
Устарело начиная с версии 3.3:
-
funcright(self, val)[source] -
[Устарело]
Примечания
Устарело начиная с версии 3.3:
-
functop(self, val)[source] -
[Устарело]
Примечания
Устарело начиная с версии 3.3:
-
funcwspace(self, val)[source] -
[Устарело]
Примечания
Устарело начиная с версии 3.3:
-
-
class matplotlib.widgets.TextBox(ax, label, initial='', color='.95', hovercolor='1', label_pad=0.01)[source] -
Bases:
matplotlib.widgets.AxesWidgetПоле ввода текста, независимое от графической среды.
Чтобы поле ввода оставалось отзывчивым, сохраняйте ссылку на него.
Вызовите
on_text_changeдля обновления при изменении текста.Вызовите
on_submitдля обновления при нажатии Enter или выходе из поля ввода.Атрибуты: -
axAxes -
Родительский объект осей для виджета.
-
labelText -
colorcolor -
Цвет поля ввода при отсутствии наведения.
-
hovercolorcolor -
Цвет поля ввода при наведении курсора.
Параметры: -
axAxes -
Экземпляр
Axes, в который будет помещено поле. -
labelstr -
Подпись для этого поля ввода.
-
initialstr -
Начальное значение в поле ввода.
-
colorcolor -
Цвет рамки поля.
-
hovercolorcolor -
Цвет рамки поля при наведении курсора.
-
label_padfloat -
Расстояние между подписью и правой стороной поля.
-
begin_typing(self, x)[source]
-
disconnect(self, cid)[source] -
Удаление наблюдателя с идентификатором соединения cid.
-
on_submit(self, func)[source] -
При нажатии Enter или выходе из поля ввода, вызовите func с событием.
Возвращается идентификатор соединения, который можно использовать для отключения.
-
on_text_change(self, func)[source] -
При изменении текста вызовите func с событием.
Возвращается идентификатор соединения, который можно использовать для отключения.
-
property params_to_disable
-
position_cursor(self, x)[source]
-
set_val(self, val)[source]
-
stop_typing(self)[source]
-
property text
-
-
class matplotlib.widgets.ToolHandles(ax, x, y, marker='o', marker_props=None, useblit=True)[source] -
Bases:
objectУправляющие элементы для инструментов холста.
Параметры: -
axmatplotlib.axes.Axes -
Ось Matplotlib, на которой отображаются управляющие элементы инструментов.
-
x, y1D arrays -
Координаты управляющих элементов.
-
markerstr -
Форма маркера, используемого для отображения элемента управления. См.
matplotlib.pyplot.plot. -
marker_propsdict -
Дополнительные свойства маркера. См.
matplotlib.lines.Line2D.
-
closest(self, x, y)[source] -
Возвращает индекс и пиксельное расстояние до ближайшего индекса.
-
set_animated(self, val)[source]
-
set_data(self, pts, y=None)[source] -
Установить x и y координаты элементов управления
-
set_visible(self, val)[source]
-
property x
-
property y
-
-
class matplotlib.widgets.Widget[source] -
Bases:
objectАбстрактный базовый класс для GUI-нейтральных виджетов
-
property active -
Является ли виджет активным?
-
drawon = True
-
eventson = True
-
get_active(self)[source] -
Получить, активен ли виджет.
-
ignore(self, event)[source] -
Возвращает, следует ли игнорировать событие.
Этот метод должен вызываться в начале любого обработчика событий.
-
set_active(self, active)[source] -
Установить, активен ли виджет.
-
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/widgets_api.html