datatip
Создайте всплывающие подсказки
Описание
Всплывающие подсказки небольшие текстовые поля, которые отображают информацию об отдельных точках данных. По умолчанию всплывающим подсказкам показываем координаты точки данных.
Создание
В интерактивном режиме создайте всплывающие подсказки, нажав на точки данных на графике, для примера линейных графиков и графиков поля точек. Можно также создать всплывающие подсказки с помощью datatip функция.
Синтаксис
Описание
datatip( создает подсказку для первой нанесенной на график точки данных указанной диаграммы, например, линейного графика или график поля точек.target)
datatip(___,Name,Value) задает свойства, используя один или несколько аргументы пары "имя-значение". Задайте пары "имя-значение" после всех других аргументов.
dt = datatip(___) возвращает DataTip объект. Можно задать любое из комбинаций входных аргументов в предыдущих синтаксисах. Этот синтаксис полезен для управления свойствами всплывающих подсказок.
Входные параметры
Свойства
Всплывающие подсказки
DataIndex - Индекс нанесенных на график данных
положительное целое число
Индекс нанесенных на график данных, заданный как положительное целое число.
Например, нанесенные на график данные объекта 2-D на наборе Декартовых осей содержатся в его XData и YData свойства. Когда вы задаете DataIndex a всплывающей подсказки, MATLAB® позиционирует всплывающую подсказку на графике путем индексации в XData и YData.
Когда вы создаете всплывающие подсказки, используя это свойство, не задайте x, y, или z аргументы.
Пример: datatip(chart,'DataIndex',3) создает всплывающие подсказки в третьей нанесенной на график точке данных.
SnapToDataVertex - отображение в ближайшей точке данных
'on' (по умолчанию) | 'off'
Отображение в ближайшей точке данных, заданное как одно из следующих значений:
'on'- отображение всплывающей подсказки в ближайшей точке данных. Ближайшая точка данных зависит от типа графика. Например, на линии ближайшая точка имеет наименьшее евклидово расстояние от заданного местоположения.'off'- Отображение всплывающей подсказки в ближайшем указанном месте на графике, даже если он находится между точками данных.
InterpolationFactor - Смещение от DataIndex
0 (по умолчанию) | скаляром
Смещение от DataIndex, заданный как скаляр. Используйте это свойство для создания всплывающих подсказок между смежными точками данных на Line объект путем установки SnapToDataVertex на 'off' и InterpolationFactor в скаляр от 0 до 1.
Например, создайте всплывающие подсказки на полпути между смежными точками данных на линии путем определения InterpolationFactor как 0,5.
x = 1:4; y = 2.*x; p = plot(x,y,'-*'); dt = datatip(p,'DataIndex',2, ... 'Location','southeast', ... 'SnapToDataVertex','off', ... 'InterpolationFactor',0.5);
InterpolationFactor не поддерживается для всплывающих подсказок по всем типам объектов.
Location - Расположение
'northeast' | 'northwest' | 'southeast' | 'southwest'
Расположение относительно точки данных, заданное как одно из следующих значений:
| Значение | Описание | Внешность |
|---|---|---|
'northeast' | Правый верхний угол точки данных |
|
'northwest' | Левый верхний угол точки данных |
|
'southeast' | Нижний правый угол точки данных |
|
'southwest' | Нижний левый угол точки данных |
|
Пример: dt.Location = 'southwest';
LocationMode - Режим выбора для Location
'auto' (по умолчанию) | 'manual'
Режим выбора для Location значение свойства, заданное как одно из следующих значений:
'auto'- Thedatatipфункция автоматически выбирает местоположение.'manual'- Если вы устанавливаетеLocationсвойство,LocationModeсвойство автоматически изменяется на'manual'.
Content - содержимое всплывающих подсказок
массив ячеек
Это свойство доступно только для чтения.
Содержимое всплывающих подсказок, заданное как массив ячеек. По умолчанию содержимое чаевых данных является массивом ячеек 2 на 1 для 2D данных советами или массивом ячеек 3 на 1 для 3-D подсказок данных.
Чтобы добавить дополнительные строки к содержимому всплывающей подсказки, используйте dataTipTextRow.
Шрифт
FontNameMode - Режим выбора для FontName
'auto' (по умолчанию) | 'manual'
Режим выбора для FontName свойство, заданное как одно из следующих значений:
'auto'- Используйте то же значение, что иFontNameсвойство дляDataTipTemplateобъект, сопоставленный с графиком, которая содержит всплывающую подсказку.'manual'- Если вы устанавливаетеFontNameсвойство,FontNameModeсвойство автоматически изменяется на'manual'.
FontSize - Размер шрифта
10 (по умолчанию) | скалярное значение, больше нуля
Размер шрифта, заданный как скалярное значение, больше нуля в модули точки. Одна точка равна 1/72 дюйм.
FontSizeMode - Режим выбора размера шрифта
'auto' (по умолчанию) | 'manual'
Режим выбора размера шрифта, заданный как одно из следующих значений:
'auto'- Используйте то же значение, что иFontSizeсвойство дляDataTipTemplateобъект, сопоставленный с графиком, которая содержит всплывающую подсказку.'manual'- Если вы устанавливаетеFontSizeсвойство,FontSizeModeсвойство автоматически изменяется на'manual'.
FontAngleMode - Режим выбора для FontAngle
'auto' (по умолчанию) | 'manual'
Режим выбора для FontAngle свойство, заданное как одно из следующих значений:
'auto'- Используйте то же значение, что иFontAngleсвойство дляDataTipTemplateобъект, сопоставленный с графиком, которая содержит всплывающую подсказку.'manual'- Если вы устанавливаетеFontAngleсвойство,FontAngleModeсвойство автоматически изменяется на'manual'.
Текстовый интерпретатор, заданный в качестве одного из следующих значений:
'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'. Для встроенного режима окружите разметку одинарными долларовыми знаками ($). Для режима отображения окружите разметку знаками в два доллара ($$).
| Режим LaTeX | Пример | Результат |
|---|---|---|
| Действующий |
'$\int_1^{20} x^2 dx$' |
|
| Отображение |
'$$\int_1^{20} x^2 dx$$' |
|
Отображаемый текст использует стиль шрифта LaTeX по умолчанию. The FontName, FontWeight, и FontAngle свойства не имеют эффекта. Для изменения стиля шрифта используйте разметку LaTeX.
Максимальный размер текста, который можно использовать с интерпретатором LaTeX, составляет 1200 символов. Для многострочного текста это уменьшается примерно на 10 символов на линию.
Для примеров, которые используют TeX и LaTeX, смотрите греческие буквы и специальные символы в тексте графика. Для получения дополнительной информации о системе LaTeX, смотрите веб-сайт проекта LaTeX в https://www.latex-project.org/.
InterpreterMode - Режим выбора для Interpreter
'auto' (по умолчанию) | 'manual'
Режим выбора для Interpreter свойство, заданное как одно из следующих значений:
'auto'- Используйте то же значение, что иInterpreterсвойство дляDataTipTemplateобъект, сопоставленный с графиком, которая содержит всплывающую подсказку.'manual'- Если вы устанавливаетеInterpreterсвойство,InterpreterModeсвойство автоматически изменяется на'manual'.
Декартовы данные координат
X - Положение вдоль оси X
скаляр
Положение вдоль оси x, заданное как скаляр с использованием тех же модулей измерения, что и ваши данные.
Y - Положение вдоль оси Y
скаляр
Положение вдоль оси y, заданное как скаляр с использованием тех же модулей измерения, что и ваши данные.
Z - Положение вдоль оси Z
скаляр
Положение вдоль оси z, заданное как скаляр с использованием тех же модулей измерения, что и ваши данные.
Полярные данные координат
R - Радиус
скаляр
Радиус, заданный как скаляр с использованием тех же модулей измерения, что и ваши данные.
Это свойство применяется только к всплывающим подсказкам на полярных графиках.
Theta - Угол
скаляр
Угол, заданный в виде скаляра в степенях.
Это свойство применяется только к всплывающим подсказкам на полярных графиках.
Географические данные координат
Latitude - Широта
скаляр
Широта, заданная как скаляр в степенях.
Это свойство применяется только к всплывающим подсказкам на географических участках.
Longitude - Долгота
скаляр
Долгота, заданная как скаляр в степенях.
Это свойство применяется только к всплывающим подсказкам на географических участках.
Интерактивность
ContextMenu - Контекстное меню
ContextMenu объект (по умолчанию)
Контекстное меню, заданное как ContextMenu объект, который обеспечивает опции всплывающих подсказок. Вы не можете задать это свойство.
Коллбэки
Контроль выполнения обратного вызова
Родитель/ребенок
Parent - Родительский элемент
объект со DataTipTemplate свойство
Родительский элемент, заданный как объект с DataTipTemplate свойство. Примеры объектов с шаблоном всплывающих подсказок включают Line, Histogram, Surface, и FunctionLine объекты. Переместите всплывающую подсказку к другому объекту путем установки этого свойства.
Идентификаторы
Type - Тип графического объекта
'datatip'
Это свойство доступно только для чтения.
Тип графического объекта, возвращенный как 'datatip'. Используйте это свойство для поиска всех объектов заданного типа в иерархии графических изображений, например, при поиске типа с помощью findobj.
Примеры
Создание всплывающих подсказок с использованием координат
Постройте график данных на диаграмме поля точек и верните Scatter объект. Затем создайте всплывающую подсказку в определенной точке данных путем определения координат x и y.
x = linspace(0,10,11); y = x.^2; sc = scatter(x,y); dt = datatip(sc,7,49);
Создание Всплывающей подсказки с использованием индекса
Постройте график данных на столбчатой диаграмме и верните Bar объект. Затем создайте всплывающую подсказку на седьмой панели путем определения DataIndex аргумент пары "имя-значение".
x = 1900:10:2000;
y = [75 91 105 123.5 131 120 107 96 82 73 70];
b = bar(x,y);
dt = datatip(b,'DataIndex',7);
Создание Всплывающей подсказки с использованием аппроксимации координат
Постройте график данных на диаграмме поля точек и верните Scatter объект. Создайте всплывающие подсказки в точке данных около (3,0) путем определения x = 3 и y = 0 в качестве приблизительных координат. Когда вы создаете всплывающую подсказку с использованием приблизительных координат, всплывающая подсказка появляется в ближайшей точке данных.
x = linspace(0,2*pi,20);
y = sin(x);
sc = scatter(x,y);
grid on;
dt = datatip(sc,3,0);
Создайте Всплывающую подсказку между точками данных
Постройте график данных и верните Line объект. Показать маркер в каждой нанесенной на график точке данных. Затем создайте всплывающую подсказку между двумя точками данных путем определения координат x и y для всплывающей подсказки и определения SnapToDataVertex аргумент пары "имя-значение" как 'off'.
x = linspace(1,10,10); y = 2.*x; p = plot(x,y,'-*'); dt = datatip(p,3.5,7,'SnapToDataVertex','off');
