dataTipTextRow

Добавьте строку к всплывающим подсказкам

Описание

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

Создание

Описание

пример

r = dataTipTextRow(label,value) создает новую строку всплывающей подсказки, которая использует заданную метку и источник значения.

r = dataTipTextRow(label,value,format) дополнительно задает формат для отображенных значений.

Свойства

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

Пометьте в виде вектора символов или строкового скаляра.

Пример: 'My Label'

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

Пример: 'XData' задает источник значения как XData свойство нанесенного на график объекта.

Пример: [1 2 3 4 5] задает источник значения как вектор.

Пример: @(x)sin(x) задает указатель на функцию где x XData значения объекта.

Пример: @(x,y)sin(y) задает указатель на функцию где y YData значения объекта.

Формат значения в виде 'auto' или вектор символов или строковый скаляр с числовым, datetime или форматом длительности. Тип формата, который вы задаете, должен совпадать с типом значений в Value свойство.

Пример: r = dataTipTextRow(label,value,'usd') задает предопределенный числовой формат за доллары США.

Пример: r = dataTipTextRow(label,value,'%#4.4g') задает числовой формат.

Пример: r = dataTipTextRow(label,value,'yyyy-MM-dd') задает формат datetime.

Пример: r = dataTipTextRow(label,value,'hh:mm:ss') задает формат длительности.

Числовые форматы

Можно задать один из предопределенных форматов, перечисленных в этой таблице. В качестве альтернативы можно задать пользовательский числовой формат.

Предопределенный форматОписание
'usd'

Доллары США. Эта опция является эквивалентным использованием '$%,.2f'. Если метки используют экспоненциальное представление, эта опция устанавливает значение экспоненты к 0.

'eur'

Евро. Эта опция эквивалентна использованию '\x20AC%,.2f' со значением экспоненты 0.

'gbp'

Британский фунт. Эта опция эквивалентна использованию '\x00A3%,.2f' со значением экспоненты 0.

'jpy'

Японская иена. Эта опция эквивалентна использованию '\x00A5%,d' со значением экспоненты 0.

'degrees'

Отобразите символ степени после значений. Эта опция эквивалентна использованию '%g\x00B0' со значением экспоненты по умолчанию.

'percentage'

Отобразите знак процента после значений. Эта опция эквивалентна использованию '%g%%' со значением экспоненты по умолчанию.

'auto'

Формат по умолчанию '%g' со значением экспоненты по умолчанию.

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

Sample custom character vector with required and optional identifiers

Идентификаторы являются дополнительными, кроме символа преобразования и знака процента. Создайте формат в этом порядке:

  • Знак процента

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

  • Ширина поля — Минимальное количество символов, чтобы распечатать в метке в виде галочки. Задайте ширину поля как целочисленное значение. Если количество значительных цифр в значении деления меньше, чем ширина поля, то метка дополнена пробелами.

  • Точность — Количество цифр справа от десятичной точки или количество значительных цифр, в зависимости от символа преобразования. Задайте точность как целочисленное значение.

  • Символ преобразования — тип Значения. Для полного списка опций см. таблицу символов преобразования. Если вы задаете преобразование, которое не соответствует данным, MATLAB® заменяет заданное преобразование и использует %e.

Кроме того, можно задать буквенный текст вначале или конец формата. Чтобы распечатать одну кавычку, используйте ''. Чтобы распечатать символ процента, используйте %%.

  • '$%.2f' — Отобразите знак доллара перед каждым значением и используйте представление с фиксированной точкой с двумя десятичными значениями.

  • '%.3f Million' — Отобразите Million после каждого значения и представления с фиксированной точкой использования с тремя десятичными значениями.

Дополнительный флагОписаниеПример числового формата
+Распечатайте символ знака (+) для положительных значений, таких как '+100'.'%+4.4g'
0Заполните ширину поля начальными нулями вместо пробелов, таких как '0100'.'%04.4g'
Лево-выровняйте по ширине, который заполняет конец значения с пробелами вместо начала. Например, если шириной поля является 4, затем этот флаг форматирует метку как '100 ' вместо ' 100'.'%-4.4g'
#

Для %fE, и %g символы преобразования, распечатайте десятичную точку, даже когда точность 0, такие как '100.'. Для %g, не удаляйте конечные нули.

'%#4.4g'
Символ преобразованияОписаниеПример
d или iЦелое число со знаком с основой 10. Значение точности указывает на количество значительных цифр. '%.4d' отображения π как 0003.
fПредставление с фиксированной точкой. Значение точности указывает на количество десятичных разрядов.'%.4f' отображения π как 3.1416.
eЭкспоненциальное представление. Значение точности указывает на количество десятичных разрядов.'%.4e' отображения π как 3.1416x100.
gБолее компактная версия e или f, без конечных нулей. Значение точности указывает на максимальное количество десятичных разрядов.'%.4g' отображения π как 3.1416.

Форматы datetime

Эта таблица показывает несколько распространенных форматов и включает примеры отформатированного входа для даты, суббота, 19 апреля 2014 в 9:41:06.12345 PM в Нью-Йорке.

Значение FormatПример
'yyyy-MM-dd'2014-04-19
'dd/MM/yyyy'19/04/2014
'dd.MM.yyyy'19.04.2014
'yyyy年 MM月 dd日'2014年 04月 19日
'MMMM d, yyyy'April 19, 2014
'eeee, MMMM d, yyyy h:mm a'Saturday, April 19, 2014 9:41 PM
'MMMM d, yyyy HH:mm:ss Z'April 19, 2014 21:41:06 -0400
'yyyy-MM-dd''T''HH:mmXXX' 2014-04-19T21:41-04:00

Следующие таблицы показывают идентификаторы буквы, что можно использовать, чтобы создать форматы datetime. Чтобы разделить поля, используйте символы небуквы, такие как дефис, пробел, двоеточие или любой символ non-ASCII. Идентификаторы соответствуют Unicode® Стандарт языка разметки данных локали (LDML) для дат.

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

Обозначьте буквами идентификаторОписаниеОтображение
GЭраCE
yГод, без начальных нулей. Смотрите, Обратите внимание на то, что следует этой таблице.2014
yyГод, с помощью последних двух цифр. Смотрите, Обратите внимание на то, что следует этой таблице.14
yyy, yyyy ...Год, с помощью, по крайней мере, количество цифр задан количеством экземпляров 'y'В течение года 2014, 'yyy' отображения 2014, в то время как 'yyyyy' отображения 02014.
u, uu, ...Год ISO. Один номер, определяющий год. Значение года ISO присваивает положительные значения годам CE и отрицательные величины к годам BCE с 1 BCE быть годом 0.2014
QЧетверть, с помощью одной цифры2
QQЧетверть, с помощью двух цифр02
QQQЧетверть, сокращеннаяQ2
QQQQЧетверть, полное имя2nd quarter
MМесяц, числовое использование одной или двух цифр4
MMМесяц, числовое использование двух цифр04
MMMМесяц, сокращенное имяApr
MMMMМесяц, полное имяApril
MMMMMМесяц, использованный для своей выгоды сначала, обозначает буквамиA
WНеделя месяца1
dДень месяца, с помощью одной или двух цифр5
ddДень месяца с помощью двух цифр05
DДень года, с помощью один, две или три цифры95
DDДень года с помощью двух цифр95
DDDДень года с помощью трех цифр095
eДень недели, числовое использование одной или двух цифр.7, где воскресенье является первым днем недели.
eeДень недели, числовое использование двух цифр07
eeeДень, сокращенное имяSat
eeeeДень, полное имяSaturday
eeeeeДень, использованный для своей выгоды сначала, обозначает буквамиS
aДневной период (AM или PM)PM
hЧас, 12-часовое обозначение часов с помощью одной или двух цифр9
hhЧас, 12-часовое обозначение часов с помощью двух цифр09
HЧас, 24-часовое обозначение часов с помощью одной или двух цифр21
HHЧас, 24-часовое обозначение часов с помощью двух цифр21
mМинута, с помощью одной или двух цифр41
mmМинута, с помощью двух цифр41
sВо-вторых, с помощью одной или двух цифр6
ssВо-вторых, использование двух цифр06
S, SS..., SSSSSSSSSДоля секунды, с помощью количества цифр задана количеством экземпляров 'S' (до 9 цифр).'SSS' обрезает 6,12345 секунд до 123.

Некоторые советы и факторы:

  • Если вы читаете номер года 2D цифры и задаете формат как y или yy, затем год центра определяет век, которому принадлежит год.

  • Используйте один или несколько u символы вместо y символы, чтобы представлять год при работе с числами года около нуля.

  • Значения datetime позже, чем CE 144 683 лет или перед 140743 BCE отображают только числа года, независимо от заданного значения формата.

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

Обозначьте буквами идентификаторОписаниеОтображение
zСокращенное имя часового пояса возмещено. Если это значение не доступно, то смещение часового пояса использует короткий формат UTC, такой как UTC-4.EDT
ZISO 8601 основной формат с часами, минутами и дополнительными полями секунд.-0400
ZZZZДлинный формат UTC.UTC-04:00
ZZZZZРасширенный формат ISO 8601 с часами, минутами и дополнительными полями секунд. Смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC.-04:00
x или XISO 8601 основной формат с полем часов и дополнительным мелким полем. Если вы задаете X, смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC.-04
xx или XXISO 8601 основной формат с часами и мелкими полями. Если вы задаете XX, смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC.-0400
xxx или XXXРасширенный формат ISO 8601 с часами и мелкими полями. Если вы задаете XXX, смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC.-04:00
xxxx или XXXXISO 8601 основной формат с часами, минутами и дополнительными полями секунд. Если вы задаете XXXX, смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC.-0400
xxxxx или XXXXXРасширенный формат ISO 8601 с часами, минутами и дополнительными полями секунд. Если вы задаете XXXXX, смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC.-04:00

Форматы длительности

Форматы длительности могут быть любой одним номером с единицами измерения времени (такими как '0.5 yrs') или цифровой таймер (такой как 'hh:mm:ss' в течение многих часов, минут и секунд).

Для чисел с единицами измерения времени задайте одно из следующего:

  • 'y' — Годы фиксированной длины, где один год равняется 365,2425 дням

  • 'd' — Дни фиксированной длины, где однажды равняется 24 часам

  • 'h' часы

  • 'm' минуты

  • 's' секунды

Для цифровых форматов таймера задайте одно из следующего:

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

  • Любой из первых трех форматов, максимум с девятью S символы, чтобы указать на цифры доли секунды, такие как 'hh:mm:ss.SSSS'

Примеры

свернуть все

Загрузите демонстрационные данные о несчастном случае и создайте график рассеивания. Затем добавьте третью строку во всплывающие подсказки по умолчанию. Для метки используйте State. Для источника значения используйте statelabel переменная рабочей области. После того, как вы создадите новую строку, добавьте его в DataTipTemplate свойство для Scatter объект.

load('accidents.mat','hwydata','statelabel')
s = scatter(hwydata(:,5),hwydata(:,4));
row = dataTipTextRow('State',statelabel);
s.DataTipTemplate.DataTipRows(end+1) = row;

Создайте всплывающую подсказку в интерактивном режиме или при помощи datatip функция.

dt = datatip(s,11246.7,1493);

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

Постройте график значений синуса. Добавьте третью строку во всплывающие подсказки по умолчанию, чтобы показать значения косинуса. Задайте числовой формат для отображенных значений косинуса. В этом случае используйте '%+4.4g' включать символ знака (+) для положительных значений. После того, как вы создадите новую строку, добавьте его в DataTipTemplate свойство для Line объект.

x = linspace(0,10);
y1 = sin(x);
y2 = cos(x);
p = plot(x,y1);
row = dataTipTextRow('Cosine',y2,'%+4.4g');
p.DataTipTemplate.DataTipRows(end+1) = row;

Создайте всплывающую подсказку в интерактивном режиме или при помощи datatip функция.

dt = datatip(p,6.56566,0.27873);

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

Введенный в R2019a