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

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

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

МодификаторОписаниеПример
^{ }Верхний индекс'text^{superscript}'
_{ }Индекс'text_{subscript}'
\bfПолужирный шрифт'\bf text'
\itИталический шрифт'\it text'
\slКосой шрифт (обычно тот же, что и курсивный шрифт)'\sl text'
\rmОбычный шрифт'\rm text'
\ fontname {specifier}Название шрифта - Заменить specifier с именем семейства шрифтов. Это можно использовать в сочетании с другими модификаторами.'\fontname{Courier} text'
\ fontsize {specifier}Размер шрифта - Заменить specifier с числовым скаляром значением в модули точек.'\fontsize{15} text'
\ цвет {specifier}Цвет шрифта - Заменить specifier с одним из следующих цветов: red, green, yellow, magenta, blue, black, white, gray, 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, составляет 1200 символов. Для многострочного текста это уменьшается примерно на 10 символов на линию.

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

Режим Data Cursor, заданный как 'off' или 'on'.

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

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

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

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

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

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

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

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

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

getCursorInfo

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

  • Target - Объект с DataTipTemplate свойство, такое как Line, Histogram, Surface, или FunctionLine.

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

  • DataIndex (для Line только объекты) - индекс нанесенных на график данных. Например, нанесенные на график данные объекта 2-D на наборе Декартовых осей содержатся в его 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 объект.

Во-первых, задайте функцию обратного вызова, которая принимает всплывающую подсказку информацию и возвращает настроенный текст. The 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