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( устанавливает режим Data Cursor для графиков на заданном рисунке. Задайте дополнительный аргумент следующим fig,___)'on', 'off', или 'toggle'. Для примера используйте datacursormode(fig,'on').
dcm = datacursormode создает объект диспетчера Data Cursor для текущей фигуры. Этот синтаксис полезен для управления режима Data Cursor, стилем отображения всплывающих подсказок и форматом текста всплывающих подсказок.
dcm = datacursormode( создает объект диспетчера Data Cursor для заданного рисунка.fig)
Входные параметры
Свойства
SnapToDataVertex - отображение в ближайшей точке данных
'on' (по умолчанию) | 'off'
Отображение в ближайшей точке данных, заданное как одно из следующих значений:
'on'- Отобразите всплывающие подсказки в ближайшей точке данных. Ближайшая точка данных зависит от типа графика. Например, на линии ближайшая точка имеет наименьшее евклидово расстояние от заданного местоположения.'off'- Отобразите всплывающие подсказки в месте, по которому вы кликните, даже если они находятся между точками данных.
DisplayStyle - Стиль отображения всплывающих подсказок
'datatip' (по умолчанию) | 'window'
Стиль отображения всплывающих подсказок, заданный как одно из следующих значений:
'datatip'- Отображать всплывающие подсказки как небольшие текстовые поля, присоединенные к значениям данных. Создайте несколько всплывающих подсказок, удерживая Shift при выборе точек данных. Если выключить режим Data Cursor, существующие всплывающие подсказки останутся на графике.'window'- отображение всплывающих подсказок в подвижном окне на рисунке. Когда стиль отображения'window'можно отображать только по одной всплывающей подсказке за раз. Если выключить режим Data Cursor, окно закроется.
Interpreter - Текстовый интерпретатор
'tex' (по умолчанию) | 'latex' | 'none'
Текстовый интерпретатор, заданный в качестве одного из следующих значений:
'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 | Название шрифта - Заменить | '\fontname{Courier} text' |
\ fontsize | Размер шрифта - Заменить | '\fontsize{15} text' |
\ цвет | Цвет шрифта - Заменить red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange, или lightBlue. | '\color{magenta} text' |
\color[rgb]{specifier} | Цвет пользовательского шрифта - Заменить | '\color[rgb]{0,0.5,0.5} text' |
В этой таблице перечислены поддерживаемые специальные символы для 'tex' интерпретатор.
| Последовательность символов | Символ | Последовательность символов | Символ | Последовательность символов | Символ |
|---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
|
|
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ |
| ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
Разметка 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/.
Enable - Режим Data Cursor
'off' (по умолчанию) | 'on'
Режим Data Cursor, заданный как 'off' или 'on'.
UpdateFcn - Функция обратного вызова, которая форматирует текст всплывающих подсказок
[] (по умолчанию) | указатель на функцию
Функция обратного вызова, которая форматирует текст всплывающих подсказок, заданный как указатель на функцию.
Используйте это свойство для форматирования содержимого всплывающих подсказок. MATLAB передает функции обратного вызова два аргумента:
empty- Пустой аргумент. Замените его на символ tilde (~) в функции, чтобы указать, что он не используется.info- Структура, содержащая информацию о всплывающей подсказке. Theinfoаргумент имеет два поля,TargetиPosition. TheTargetполе содержит объект сDataTipTemplateсвойство. ThePositionполе содержит координаты всплывающих подсказок.
Функция должна быть в пути MATLAB или в текущей папке. Кроме того, можно выбрать функцию, которая не находится в пути MATLAB, выбрав Update Function > Choose from File из контекстного меню всплывающих подсказок.
Для получения дополнительной информации об коллбэках см. Раздел «Определение коллбэка»
Figure - Объект фигуры
Figure объект
Это свойство доступно только для чтения.
Figure объект, в котором всплывающие подсказки появляются.
Функции объекта
getCursorInfo |
|
Примеры
Отображение всплывающих подсказок в окне Moveable
Постройте график некоторых данных, создайте DataCursorManager Объект и включите режим Data Cursor. Отобразите содержимое всплывающих подсказок в подвижном окне путем установки DisplayStyle свойство к 'window'. Затем создайте всплывающую подсказку, нажав на точку данных. Вы можете переместить окно всплывающих подсказок, нажав на заголовок окна и перетащив его.
x = linspace(0,5,30); y = exp(x); scatter(x,y) dcm = datacursormode; dcm.Enable = 'on'; dcm.DisplayStyle = 'window';
Настройка текста всплывающих подсказок
Настройте текст всплывающих подсказок путем установки 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;
Совет
В целых всплывающих подсказках покажем координаты выбранной точки данных. Однако для некоторых типов графиков всплывающие подсказки отображают специализированную информацию. Для примера гистограммы, созданные с помощью
histogramфункции отображают всплывающие подсказки, которые детализируют счетчики наблюдений и границ интервала.Чтобы программно создать и настроить всплывающие подсказки, используйте
datatipиdataTipTextRowфункций. Дополнительные сведения см. в разделе Создание пользовательских всплывающих подсказок.