exponenta event banner

datatip

Создать подсказку по данным

Описание

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

Создание

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

Описание

datatip(target) создает всплывающую точку данных в первой выводимой на печать точке данных указанной диаграммы, такой как линия или график рассеяния.

пример

datatip(target,x,y) создает всплывающую подсказку данных на 2-D выводимой на печать точке данных, указанной x и y. Если указать приблизительные координаты, то datatip создает подсказку данных в ближайшей точке данных.

datatip(target,x,y,z) создает всплывающую подсказку данных на 3-D выводимой на печать точке данных, указанной x, y, и z. Если указать приблизительные координаты, то datatip создает подсказку данных в ближайшей точке данных.

пример

datatip(target,'DataIndex',n) создает подсказку данных на nВ-й выводимой на печать точке данных путем установки DataIndex собственность.

datatip(___,Name,Value) задает свойства, использующие один или несколько аргументов пары имя-значение. Укажите пары имя-значение после всех остальных аргументов.

dt = datatip(___) возвращает DataTip объект. Можно указать любую комбинацию входных аргументов в предыдущих синтаксисах. Этот синтаксис полезен для управления свойствами подсказки данных.

Входные аргументы

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

Цель, указанная как объект с DataTipTemplate собственность. Примеры объектов с DataTipTemplate свойство include Line, Histogram, Surface, и FunctionLine объекты.

Первая координата кончика данных, заданная как скаляр. Интерпретация первой координаты зависит от типа осей:

  • Для декартовых осей первой координатой является положение оси X с использованием тех же единиц измерения, что и данные.

  • Для полярных осей первая координата - это полярный угол в радианах.

  • Для географических осей первой координатой является широта в градусах.

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

Для создания подсказок по данным между точками данных установите SnapToDataVertex свойство для 'off'.

Вторая координата кончика данных, заданная как скаляр. Интерпретация второй координаты зависит от типа осей:

  • Для декартовых осей вторая координата - это положение оси Y с использованием тех же единиц измерения, что и данные.

  • Для полярных осей второй координатой является радиус r в тех же единицах, что и данные.

  • Для географических осей вторая координата - долгота в градусах.

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

Для создания подсказок по данным между точками данных установите SnapToDataVertex свойство для 'off'.

Третья координата кончика данных, заданная как скаляр. Для декартовых осей третьей координатой является положение оси Z с использованием тех же единиц измерения, что и данные.

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

Для создания подсказок по данным между точками данных установите SnapToDataVertex свойство для 'off'.

Свойства

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

Совет по данным

Индекс выводимых на печать данных, заданный как положительное целое число.

Например, выводимые на печать данные объекта 2-D на наборе декартовых осей содержатся в его XData и YData свойства. При указании DataIndex подсказки данных MATLAB ® размещает подсказку данных на диаграмме путем индексирования вXData и YData.

При создании подсказки данных с помощью этого свойства не указывайте x, y, или z аргументы.

Пример: datatip(chart,'DataIndex',3) создает вершину данных в третьей точке данных, выводимой на печать.

Отображение в ближайшей точке данных, указанной как одно из следующих значений:

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

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

Смещение от 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);

Line plot with data points displayed as asterisks and a data tip between asterisks

InterpolationFactor не поддерживается для подсказок по данным для всех типов объектов.

Местоположение относительно точки данных, указанное как одно из следующих значений:

СтоимостьОписаниеВнешность
'northeast'Верхний правый угол точки данных

Sample data tip at the top-right corner of the data point

'northwest'Верхний левый угол точки данных

Sample data tip at the top-left corner of the data point

'southeast'Нижний правый угол точки данных

Sample data tip at the bottom-right corner of the data point

'southwest'Нижний левый угол точки данных

Sample data tip at the bottom-left corner of the data point

Пример: dt.Location = 'southwest';

Режим выбора для Location значение свойства, указанное как одно из следующих значений:

  • 'auto'- datatip функция автоматически выбирает местоположение.

  • 'manual' - Если установить Location свойство, LocationMode свойство автоматически изменяется на 'manual'.

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

Содержимое подсказки данных, указанное как массив ячеек. По умолчанию содержимое подсказок представляет собой массив ячеек 2 на 1 для подсказок 2-D данных или массив ячеек 3 на 1 для подсказок 3-D данных.

Чтобы добавить дополнительные строки в содержимое подсказки данных, используйте dataTipTextRow.

Шрифт

Имя шрифта, указанное как имя поддерживаемого шрифта или 'FixedWidth'. Для правильного отображения и печати текста необходимо выбрать шрифт, поддерживаемый системой. Шрифт по умолчанию зависит от операционной системы и языка.

Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любом языковом стандарте, используйте 'FixedWidth'. Шрифт фиксированной ширины зависит от корня FixedWidthFontName собственность. Установка корня FixedWidthFontName приводит к немедленному обновлению отображения для использования нового шрифта.

Режим выбора для FontName свойство, указанное как одно из следующих значений:

  • 'auto' - Использовать то же значение, что и FontName для свойства DataTipTemplate объект, связанный с диаграммой, содержащей подсказку данных.

  • 'manual' - Если установить FontName свойство, FontNameMode свойство автоматически изменяется на 'manual'.

Размер шрифта, заданный как скалярное значение, большее нуля в единицах измерения точки. Одна точка равна 1/72 дюйм.

Режим выбора размера шрифта, указанный как одно из следующих значений:

  • 'auto' - Использовать то же значение, что и FontSize для свойства DataTipTemplate объект, связанный с диаграммой, содержащей подсказку данных.

  • 'manual' - Если установить FontSize свойство, FontSizeMode свойство автоматически изменяется на 'manual'.

Наклон символа, указан как 'normal' или 'italic'.

Не все шрифты имеют оба стиля шрифтов. Поэтому курсив может выглядеть так же, как и обычный шрифт.

Режим выбора для 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{specifier}Имя шрифта - Заменить specifier с именем семейства шрифтов. Это можно использовать в сочетании с другими модификаторами.'\fontname{Courier} text'
\fontsize{specifier}Размер шрифта - Заменитьspecifier с числовым скалярным значением в единицах измерения точки.'\fontsize{15} text'
\color{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'. Для встроенного режима окружить разметку однодолларовыми знаками ($). Для режима отображения обведите разметку двойными знаками доллара ($$).

Режим LaTeXПримерРезультат
Действующий

'$\int_1^{20} x^2 dx$'

Equation with LaTeX inline mode.

Показ

'$$\int_1^{20} x^2 dx$$'

Equation with LaTeX display mode.

В отображаемом тексте используется стиль шрифта LaTeX по умолчанию. FontName, FontWeight, и FontAngle свойства не имеют эффекта. Чтобы изменить стиль шрифта, используйте разметку LaTeX.

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

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

Режим выбора для Interpreter свойство, указанное как одно из следующих значений:

  • 'auto' - Использовать то же значение, что и Interpreter для свойства DataTipTemplate объект, связанный с диаграммой, содержащей подсказку данных.

  • 'manual' - Если установить Interpreter свойство, InterpreterMode свойство автоматически изменяется на 'manual'.

Декартовы данные координат

Расположение вдоль оси X, заданной как скаляр с использованием тех же единиц измерения, что и данные.

Расположение вдоль оси Y, заданной как скаляр с использованием тех же единиц измерения, что и данные.

Расположение вдоль оси Z, заданной как скаляр с использованием тех же единиц измерения, что и данные.

Полярные данные координат

Радиус, заданный как скаляр с использованием тех же единиц измерения, что и данные.

Это свойство применяется только к подсказкам данных на полярных графиках.

Угол, заданный как скаляр в градусах.

Это свойство применяется только к подсказкам данных на полярных графиках.

Данные о географических координатах

Широта, заданная как скаляр в градусах.

Это свойство применяется только к подсказкам по данным на географических участках.

Долгота, заданная как скаляр в градусах.

Это свойство применяется только к подсказкам по данным на географических участках.

Интерактивность

Состояние видимости, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Просмотр объекта.

  • 'off' - Скрыть объект, не удаляя его. По-прежнему можно получить доступ к свойствам невидимого объекта.

Контекстное меню, указанное как ContextMenu объект, предоставляющий параметры подсказки данных. Невозможно задать это свойство.

Состояние выбора, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Выбрано. Если щелкнуть объект в режиме редактирования печати, то MATLAB задает его Selected свойство для 'on'. Если SelectionHighlight свойство также имеет значение 'on'затем MATLAB отображает дескрипторы выбора вокруг объекта.

  • 'off' - Не выбрано.

Отображение маркеров выбора при выборе, указанных как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Отображение дескрипторов выбора, когда Selected свойство имеет значение 'on'.

  • 'off' - Никогда не отображать дескрипторы выбора, даже когда Selected свойство имеет значение 'on'.

Отзывы

Обратный вызов щелчком мыши, указанный как одно из следующих значений:

  • Дескриптор функции

  • Массив ячеек, содержащий дескриптор функции и дополнительные аргументы

  • Символьный вектор, являющийся допустимой командой или функцией MATLAB, которая вычисляется в базовой рабочей области (не рекомендуется)

Это свойство используется для выполнения кода при щелчке по объекту. Если это свойство задается с помощью дескриптора функции, MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:

  • Clicked object - доступ к свойствам нажатого объекта из функции обратного вызова.

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

Дополнительные сведения об использовании дескрипторов функций для определения функций обратного вызова см. в разделе Определение обратного вызова.

Примечание

Если PickableParts свойство имеет значение 'none' или если HitTest свойство имеет значение 'off', то этот обратный вызов не выполняется.

Функция создания объекта, заданная как одно из следующих значений:

  • Дескриптор функции.

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

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.

Дополнительные сведения об указании обратного вызова в качестве дескриптора функции, массива ячеек или символьного вектора см. в разделе Определение обратного вызова.

Это свойство определяет функцию обратного вызова, выполняемую при создании объекта MATLAB. MATLAB инициализирует все значения свойств перед выполнением CreateFcn обратный вызов. Если не указать CreateFcn , то MATLAB выполняет функцию создания по умолчанию.

Установка CreateFcn свойство существующего компонента не оказывает никакого влияния.

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

Функция удаления объекта, заданная как одно из следующих значений:

  • Дескриптор функции.

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

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.

Дополнительные сведения об указании обратного вызова в качестве дескриптора функции, массива ячеек или символьного вектора см. в разделе Определение обратного вызова.

Это свойство определяет функцию обратного вызова, выполняемую при удалении объекта MATLAB. MATLAB выполняет команду DeleteFcn обратный вызов перед уничтожением свойств объекта. Если не указать DeleteFcn , то MATLAB выполняет функцию удаления по умолчанию.

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

Управление выполнением обратного вызова

Прерывание обратного вызова, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Это свойство определяет, можно ли прервать выполняющийся обратный вызов. Существует два состояния обратного вызова:

  • Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.

  • Обратный вызов с прерыванием - это обратный вызов, который пытается прервать выполняющийся обратный вызов.

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов (если он существует). Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание.

  • Значение 'on' позволяет другим обратным вызовам прерывать обратные вызовы объекта. Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь, например, при наличии drawnow, figure, uifigure, getframe, waitfor, или pause команда.

    • Если выполняемый обратный вызов содержит одну из этих команд, MATLAB останавливает выполнение обратного вызова в этот момент и выполняет прерванный обратный вызов. MATLAB возобновляет выполнение выполняющегося обратного вызова после завершения прерванного обратного вызова.

    • Если выполняемый обратный вызов не содержит одну из этих команд, MATLAB завершает выполнение обратного вызова без прерывания.

  • Значение 'off' блокирует все попытки прерывания. BusyAction свойство объекта, владеющего прерывистым обратным вызовом, определяет, отбрасывается ли прерывистый обратный вызов или помещается в очередь.

Примечание

Прерывание и выполнение обратного вызова ведут себя по-разному в следующих ситуациях:

  • Если обратный вызов с прерыванием является DeleteFcn, CloseRequestFcn или SizeChangedFcn обратный вызов, то прерывание происходит независимо от Interruptible значение свойства.

  • Если выполняемый обратный вызов в данный момент выполняется waitfor функция, то прерывание происходит независимо от Interruptible значение свойства.

  • Timer объекты выполняются в соответствии с графиком независимо от Interruptible значение свойства.

Когда происходит прерывание, MATLAB не сохраняет состояние свойств или отображения. Например, объект, возвращенный gca или gcf при выполнении другого обратного вызова команда может измениться.

Очередь обратного вызова, указанная как 'queue' или 'cancel'. BusyAction определяет, как MATLAB обрабатывает выполнение прерывания обратных вызовов. Существует два состояния обратного вызова:

  • Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.

  • Обратный вызов с прерыванием - это обратный вызов, который пытается прервать выполняющийся обратный вызов.

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов. Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction свойство объекта, владеющего прерывистым обратным вызовом, определяет, отбрасывается он или помещается в очередь. Это возможные значения BusyAction свойство:

  • 'queue' - помещает обратный вызов с прерыванием в очередь, подлежащую обработке после завершения выполнения обратного вызова.

  • 'cancel' - не выполняет обратный вызов прерывания.

Возможность захвата щелчков мыши, указанных как одно из следующих значений:

  • 'visible' - Захват щелчков мыши при отображении. Visible свойство должно иметь значение 'on' и необходимо щелкнуть на части DataTip объект, имеющий определенный цвет. Нельзя щелкнуть деталь, для которой свойство цвета имеет значение 'none'. HitTest определяет, DataTip объект отвечает на клик или если это делает предок.

  • 'all' - Захват щелчков мыши независимо от видимости. Visible свойство может иметь значение 'on' или 'off' и вы можете щелкнуть часть DataTip объект, не имеющий цвета. HitTest определяет, DataTip объект отвечает на клик или если это делает предок.

  • 'none' - Не удается зафиксировать щелчки мыши. Щелкните значок DataTip объект передает щелчок по нему объекту под ним в текущем виде окна фигуры. HitTest свойство не имеет эффекта.

Ответ на зафиксированные щелчки мыши, указанный как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Запустить ButtonDownFcn обратный вызов DataTip объект. Если вы определили ContextMenu затем вызовите контекстное меню.

  • 'off' - Инициировать обратные вызовы для ближайшего предка DataTip объект, имеющий один из следующих объектов:

    • HitTest свойство имеет значение 'on'

    • PickableParts свойство имеет значение, которое позволяет предку фиксировать щелчки мыши

Примечание

PickableParts определяет, DataTip объект может захватывать щелчки мыши. Если он не может, то HitTest свойство не имеет эффекта.

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

Состояние удаления, возвращаемое как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.

MATLAB устанавливает BeingDeleted свойство для 'on' когда DeleteFcn обратный вызов начинает выполнение. BeingDeleted свойство остается установленным в значение 'on' до тех пор, пока объект-компонент больше не будет существовать.

Проверьте значение BeingDeleted для проверки того, что объект не будет удален перед запросом или изменением.

Родительский/дочерний

Родитель, указанный как объект с DataTipTemplate собственность. Примеры объектов с шаблоном подсказки данных включают Line, Histogram, Surface, и FunctionLine объекты. Переместите подсказку данных в другой объект, задав это свойство.

Объект не имеет дочерних элементов. Невозможно задать это свойство.

Видимость дескриптора объекта в Children свойство родительского объекта, указанное как одно из следующих значений:

  • 'on' - Дескриптор объекта всегда виден.

  • 'off' - Дескриптор объекта всегда невидим. Этот параметр полезен для предотвращения непреднамеренных изменений другой функцией. Установите HandleVisibility кому 'off' для временного скрытия дескриптора во время выполнения этой функции.

  • 'callback' - Дескриптор объекта виден из обратных вызовов или функций, вызываемых обратными вызовами, но не из функций, вызываемых из командной строки. Этот параметр блокирует доступ к объекту в командной строке, но разрешает доступ к нему функциям обратного вызова.

Если объект не указан в списке Children свойства родительского объекта, то функции, которые получают дескрипторы объектов путем поиска в иерархии объектов или запроса свойств дескрипторов, не могут вернуть его. Примеры таких функций включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close функции.

Дескрипторы скрытых объектов по-прежнему действительны. Установка корня ShowHiddenHandles свойство для 'on' перечисление всех дескрипторов объектов независимо от их HandleVisibility параметр свойства.

Идентификаторы

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

Тип графического объекта, возвращаемого как 'datatip'. Это свойство используется для поиска всех объектов данного типа в иерархии печати, например, при поиске типа с помощью findobj.

Идентификатор объекта, заданный как вектор символа или скаляр строки. Можно указать уникальный Tag для использования в качестве идентификатора объекта. При необходимости доступа к объекту в другом месте кода можно использовать findobj для поиска объекта на основе Tag значение.

Пользовательские данные, указанные как любой массив MATLAB. Например, можно указать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Это свойство используется для хранения произвольных данных объекта.

Если вы работаете в App Designer, создайте открытые или частные свойства в приложении для совместного использования данных вместо использования UserData собственность. Дополнительные сведения см. в разделе Общий доступ к данным в приложениях App Designer.

Примеры

свернуть все

Постройте график на диаграмме рассеяния и верните Scatter объект. Затем создайте подсказку данных в определенной точке данных, указав координаты x и y.

x = linspace(0,10,11);
y = x.^2;
sc = scatter(x,y);

dt = datatip(sc,7,49);

Figure contains an axes. The axes contains an object of type scatter.

Печать данных на гистограмме и возврат 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);

Figure contains an axes. The axes contains an object of type bar.

Постройте график на диаграмме рассеяния и верните 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);

Figure contains an axes. The axes contains an object of type scatter.

Постройте график данных и верните 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');

Figure contains an axes. The axes contains an object of type line.

Совет

  • Интерактивное создание подсказок по данным путем щелчка по точкам данных на диаграмме. Для назначения интерактивно созданных подсказок по данным переменной используйте findobj функция.

    dt = findobj(chart,'Type','datatip');

  • Для удаления подсказок по данным используйте delete функция.

    delete(dt);

Представлен в R2019b