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'
#

Для %f, %e, и %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. Чтобы разделить поля, используйте символы без небуква, такие как дефис, пространство, двоеточие или любой символ, отличный от ASCII. Идентификаторы соответствуют Юникоду® Язык разметки данных локали (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.

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

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

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

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

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

Идентификатор буквыОписаниеОтображение
zСокращенное имя смещения часового пояса. Если это значение недоступно, смещение часового пояса использует короткий формат UTC, такой как UTC-4.EDT
ZБазовый формат ISO 8601 с полями часов, минут и необязательных секунд.-0400
ZZZZДлинный формат UTC.UTC-04:00
ZZZZZРасширенный формат ISO 8601 с полями часов, минут и дополнительных секунд. Смещение нуля по времени отображается как индикатор ISO 8601 UTC «Z».-04:00
x или XISO 8601 базовый формат с полем часов и полем дополнительных минут. Если вы задаете Xсмещение нуля по времени отображается как индикатор ISO 8601 UTC «Z».-04
xx или XXISO 8601 базовый формат с часами и минутами полей. Если вы задаете XXсмещение нуля по времени отображается как индикатор ISO 8601 UTC «Z».-0400
xxx или XXXISO 8601 расширенный формат с полями часов и минут. Если вы задаете XXXсмещение нуля по времени отображается как индикатор ISO 8601 UTC «Z».-04:00
xxxx или XXXXБазовый формат ISO 8601 с полями часов, минут и необязательных секунд. Если вы задаете XXXXсмещение нуля по времени отображается как индикатор ISO 8601 UTC «Z».-0400
xxxxx или XXXXXРасширенный формат ISO 8601 с полями часов, минут и дополнительных секунд. Если вы задаете XXXXXсмещение нуля по времени отображается как индикатор ISO 8601 UTC «Z».-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. The axes 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. The axes contains an object of type line.

Введенный в R2019a