datacursormode

Включение режима Data Cursor

Описание

Всплывающие подсказки являются маленькими текстовыми полями, которые отображают информацию об отдельных точках данных. В релизах до R2018b используйте datacursormode функция, чтобы создать и отредактировать всплывающие подсказки. Управляйте внешним видом и поведением всплывающей подсказки при помощи datacursormode создать менеджера по Data Cursor объект.

Начиная в R2018b, можно создать и отредактировать всплывающие подсказки с помощью встроенных взаимодействий вместо этого. Встроенные взаимодействия не требуют, чтобы вы включили режим и ответили быстрее, чем режимы взаимодействия. Для получения дополнительной информации о встроенных взаимодействиях, смотрите Интерактивность Диаграммы управления.

Большинство графиков поддерживает всплывающие подсказки, включая линию, панель, гистограмму и поверхностные графики. Графики, которые поддерживают всплывающие подсказки обычно, отображают значок всплывающих подсказок на панели инструментов осей.

Создание

Описание

datacursormode on включает режим Data Cursor для графиков в текущей фигуре. С режимом Data Cursor на создайте всплывающую подсказку путем нажатия на точку данных. Чтобы создать несколько всплывающих подсказок, удержите клавишу Shift при нажатии на точки данных.

datacursormode off выключает режим Data Cursor. Эта команда не удаляет существующие всплывающие подсказки. Некоторые встроенные взаимодействия включены по умолчанию, независимо от режима. Чтобы отключить встроенные взаимодействия со всплывающими подсказками, используйте disableDefaultInteractivity функция.

datacursormode режим Data Cursor переключателей между 'on' и 'off'. Этот синтаксис совпадает с datacursormode toggle.

datacursormode(fig,___) устанавливает режим Data Cursor для графиков на заданном рисунке. Задайте дополнительный аргумент как 'on'off, или 'toggle'. Например, используйте datacursormode(fig,'on').

пример

dcm = datacursormode создает менеджера по Data Cursor объект для текущей фигуры. Этот синтаксис полезен для управления режимом Data Cursor, стилем отображения всплывающей подсказки и текстовым форматом всплывающей подсказки.

dcm = datacursormode(fig) создает менеджера по Data Cursor объект для заданной фигуры.

Входные параметры

развернуть все

Плановый показатель в виде Figure объект.

Свойства

развернуть все

Отобразитесь в самой близкой точке данных в виде одного из этих значений:

  • 'on' – Отобразите всплывающую подсказку в самой близкой точке данных. Самая близкая точка данных зависит от типа графика. Например, на линейной диаграмме самая близкая точка имеет наименьшее Евклидово расстояние от заданного местоположения.

  • 'off' – Отобразите всплывающую подсказку в местоположении, по которому вы кликаете, даже если это между точками данных.

Стиль отображения всплывающей подсказки в виде одного из этих значений:

  • 'datatip' – Отобразите всплывающие подсказки как маленькие текстовые поля, присоединенные к значениям данных. Создайте несколько всплывающих подсказок путем содержания Shift, когда вы выбираете точки данных. Если вы выключаете режим Data Cursor, существующие всплывающие подсказки остаются на графике.

  • 'window' – Отобразите всплывающие подсказки в подвижном окне в фигуре. Когда стилем отображения является 'window', можно только отобразить одну всплывающую подсказку за один раз. Если вы выключаете режим Data Cursor, завершения окна.

Текстовый интерпретатор в виде одного из этих значений:

  • 'tex' — Интерпретируйте символы с помощью подмножества разметки TeX.

  • 'latex' — Интерпретируйте символы, использующие разметку LATEX.

  • 'none' — Отобразите буквенные символы.

TeX Markup

По умолчанию, MATLAB® поддерживает подмножество разметки TeX. Используйте синтаксис TeX, чтобы добавить верхние индексы и индексы, изменить тип шрифта и окрасить и включать специальные символы в текст.

Модификаторы остаются в силе до конца текста. Верхние индексы и индексы являются исключением, потому что они изменяют только следующий символ или символы в фигурных скобках. Когда вы устанавливаете интерпретатор на 'tex', поддерживаемые модификаторы следующие.

МодификаторОписаниеПример
^{ }Верхний индекс'text^{superscript}'
_{ }Индекс'text_{subscript}'
\bfBold font'\bf text'
\itКурсивный шрифт'\it text'
\slНаклонный шрифт (обычно то же самое как курсивный шрифт)'\sl text'
\rmОбычный шрифт'\rm text'
\fontname{specifier}}Название шрифта — Замена specifier с именем семейства шрифтов. Можно использовать это в сочетании с другими модификаторами.'\fontname{Courier} text'
\fontsize{specifier}}Размер шрифта — Замена specifier со значением числового скаляра в модулях точки.'\fontsize{15} text'
\color{specifier}}Цвет шрифта — Замена specifier с одним из этих цветов: red, green, yellowПурпурный, blue, black, whiteсерый, darkGreen, orange, или lightBlue.'\color{magenta} text'
\color[rgb]{specifier}Цвет пользовательского шрифта — Замена specifier с трехэлементным триплетом RGB.'\color[rgb]{0,0.5,0.5} text'

Эта таблица приводит поддерживаемые специальные символы для 'tex' интерпретатор.

Последовательность символовСимволПоследовательность символовСимволПоследовательность символовСимвол

\alpha

α

\upsilon

υ

\sim

~

\angle

\phi

\leq

\ast

*

\chi

χ

\infty

\beta

β

\psi

ψ

\clubsuit

\gamma

γ

\omega

ω

\diamondsuit

\delta

δ

\Gamma

Γ

\heartsuit

\epsilon

ϵ

\Delta

Δ

\spadesuit

\zeta

ζ

\Theta

Θ

\leftrightarrow

\eta

η

\Lambda

Λ

\leftarrow

\theta

θ

\Xi

Ξ

\Leftarrow

\vartheta

ϑ

\Pi

Π

\uparrow

\iota

ι

\Sigma

Σ

\rightarrow

\kappa

κ

\Upsilon

ϒ

\Rightarrow

\lambda

λ

\Phi

Φ

\downarrow

\mu

µ

\Psi

Ψ

\circ

º

\nu

ν

\Omega

Ω

\pm

±

\xi

ξ

\forall

\geq

\pi

π

\exists

\propto

\rho

ρ

\ni

\partial

\sigma

σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

τ

\Re

\neq

\equiv

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

\in

\supseteq

\supset

\lceil

\subset

\int

\cdot

·

\o

ο

\rfloor

\neg

¬

\nabla

\lfloor

\times

x

\ldots

...

\perp

\surd

\prime

´

\wedge

\varpi

ϖ

\0

\rceil

\rangle

\mid

|

\vee

\langle

\copyright

©

Разметка LaTeX

Чтобы использовать разметку LATEX, установите интерпретатор на 'latex'. Используйте долларовые символы вокруг текста, например, используйте '$\int_1^{20} x^2 dx$' для встроенного режима или '$$\int_1^{20} x^2 dx$$' для режима отображения.

Отображаемый текст использует стиль шрифта LaTeX по умолчанию. Чтобы изменить стиль шрифта, используйте разметку LATEX.

Максимальный размер текста, который можно использовать с интерпретатором LaTeX, является 1 200 символами. Для многострочного текста это уменьшает приблизительно на 10 символов на строку.

Для получения дополнительной информации о системе LaTeX, смотрите веб-сайт Проекта LaTeX в https://www.latex-project.org/.

Режим Data Cursor в виде 'off' или 'on'.

Функция обратного вызова, которая форматирует текст всплывающей подсказки в виде указателя на функцию.

Используйте это свойство отформатировать содержимое всплывающих подсказок. MATLAB передает два аргумента функции обратного вызова:

  • empty – Пустой аргумент. Замените его на символ тильды (~) в функции, чтобы указать, что это не используется.

  • info – Структура, содержащая информацию о всплывающей подсказке. info аргумент имеет два поля, Target и Position. Target поле содержит объект с DataTipTemplate свойство. Position поле содержит координаты всплывающей подсказки.

Функция должна быть на пути MATLAB или в текущей папке. В качестве альтернативы можно выбрать функцию, которая не находится на пути MATLAB путем выбора Update Function > Choose from File из контекстного меню всплывающей подсказки.

Для получения дополнительной информации о коллбэках, см. Определение Коллбэка.

Это свойство доступно только для чтения.

Figure объект, в котором появляются всплывающие подсказки.

Функции объекта

getCursorInfo

info = getCursorInfo(dcm) возвращает цель и координаты каждой всплывающей подсказки на рисунке. info вектор из структур с этими полями:

  • Target – Объект с DataTipTemplate свойство, такое как LineГистограммаповерхность, или FunctionLine.

  • Position – Координаты всплывающей подсказки. Интерпретация координат зависит от типа осей. Например, координаты Осей декартовой системы координат являются x, y, и z в тех же модулях как ваши данные.

  • DataIndex (для Line только объекты) – индекс отображенных на графике данных. Например, отображенные на графике данные 2D объекта на наборе Осей декартовой системы координат содержатся в своем XData и YData свойства.

Примеры

свернуть все

Отобразите некоторые данные на графике, создайте DataCursorManager объект, и включает режим Data Cursor. Отобразите содержимое всплывающей подсказки в подвижном окне путем установки DisplayStyle свойство к 'window'. Затем создайте всплывающую подсказку путем нажатия на точку данных. Можно переместить окно всплывающей подсказки путем нажатия на заголовок окна и перетаскивание.

x = linspace(0,5,30);
y = exp(x);
scatter(x,y)
dcm = datacursormode;
dcm.Enable = 'on';
dcm.DisplayStyle = 'window';

Scatter plot with one selected point. A window in the lower-right corner displays the coordinates of the selected point.

Настройте текст всплывающей подсказки путем установки UpdateFcn свойство DataCursorMode объект.

Во-первых, задайте функцию обратного вызова, которая принимает информацию о всплывающей подсказке и возвращает настроенный текст. UpdateFcn свойство не использует первый аргумент функции обратного вызова, так замените его на ~. Возвратите индивидуально настраиваемый текст как символьный массив, в этом случае содержащий упорядоченную пару координат. Сохраните функцию как программный файл под названием displayCoordinates.m.

function txt = displayCoordinates(~,info)
    x = info.Position(1);
    y = info.Position(2);
    txt = ['(' num2str(x) ', ' num2str(y) ')'];
end

Отобразите некоторые данные на графике, включите режим Data Cursor и установите UpdateFcn свойство к функции обратного вызова. Затем создайте всплывающую подсказку путем нажатия на точку данных.

x = 1:10;
y = x.^2;
scatter(x,y)

dcm = datacursormode;
dcm.Enable = 'on';
dcm.UpdateFcn = @displayCoordinates;

Scatter plot with one data tip. The text in the data tip is an ordered pair.

Советы

  • В общем случае всплывающие подсказки показывают координаты выбранной точки данных. Однако для некоторых типов графиков, всплывающие подсказки отображают специализированную информацию. Например, гистограммы создали использование histogram функционируйте всплывающие подсказки отображения, которые перечисляют количества наблюдения и границы интервала.

  • Чтобы программно создать и настроить всплывающие подсказки, используйте datatip и dataTipTextRow функции. Для получения дополнительной информации смотрите, Создают Пользовательские всплывающие подсказки.

Представлено до R2006a