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' (значение по умолчанию) | вектор символов | представляет скаляр в виде строки
Формат значения, заданный как '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' | Доллары США. Эта опция является эквивалентным использованием |
'eur' | Евро. Эта опция эквивалентна использованию |
'gbp' | Британский фунт. Эта опция эквивалентна использованию |
'jpy' | Японская иена. Эта опция эквивалентна использованию |
'degrees' | Отобразите символ степени после значений. Эта опция эквивалентна использованию |
'percentage' | Отобразите знак процента после значений. Эта опция эквивалентна использованию |
'auto' | Формат по умолчанию |
Если ни один из форматов, упомянутых в таблице, не дает формат, вы хотите, то создаете пользовательский вектор символов или строку с идентификаторами.
Идентификаторы являются дополнительными, кроме символа преобразования и знака процента. Создайте формат в этом порядке:
Один или несколько флагов — Опции, такие как добавление знака "плюс" перед положительными значениями. Для полного списка опций см. таблицу дополнительных флагов.
Ширина поля — Минимальное количество символов, чтобы распечатать в метке в виде галочки. Задайте ширину поля как целочисленное значение. Если количество значительных цифр в значении деления меньше, чем ширина поля, то метка дополнена пробелами.
Точность — Количество цифр справа от десятичной точки или количество значительных цифр, в зависимости от символа преобразования. Задайте точность как целочисленное значение.
Символ преобразования — тип Значения. Для полного списка опций см. таблицу символов преобразования. Если вы задаете преобразование, которое не соответствует данным, MATLAB® заменяет заданное преобразование и использует
%e.
Кроме того, можно задать буквенный текст вначале или конец формата. Чтобы распечатать одну кавычку, используйте ''. Чтобы распечатать символ процента, используйте %%.
'$%.2f'— Отобразите знак доллара перед каждым значением и используйте представление с фиксированной точкой с двумя десятичными значениями.'%.3f Million'— ОтобразитеMillionпосле каждого значения и используйте представление с фиксированной точкой с тремя десятичными значениями.
| Дополнительный флаг | Описание | Пример числового формата |
|---|---|---|
+ | Распечатайте символ знака (+) для положительных значений, таких как '+100'. | '%+4.4g' |
| 0 | Заполните ширину поля начальными нулями вместо пробелов, таких как '0100'. | '%04.4g' |
– | Лево-выровняйте по ширине, который заполняет конец значения с пробелами вместо начала. Например, если шириной поля является 4, то этот флаг форматирует метку как '100 ' вместо ' 100'. | '%-4.4g' |
# | Для | '%#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 в Нью-Йорке.
| Формат | Пример |
|---|---|
'yyyy-MM-dd' | 2014-04-19 |
'dd/MM/yyyy' | 19/04/2014 |
'dd.MM.yyyy' | 19.04.2014 |
'yyyy年 MM月 dd日' | 2014年 04月 19日 (Символы для японской локали, ja_JP) |
'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 |
'yyyy-MM-dd HH:mm:ss.SSS' | 2014-04-19 21:41:06.123 |
Следующие таблицы показывают идентификаторы буквы, что можно использовать, чтобы создать форматы datetime. Чтобы разделить поля, используйте символы небуквы, такие как дефис, пробел, двоеточие или любой символ non-ASCII. Идентификаторы соответствуют Unicode® Locale Data Markup Language (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 |
Z | ISO 8601 основной формат с часами, минутами и дополнительными полями секунд. | -0400 |
ZZZZ | Длинный формат UTC. | UTC-04:00 |
ZZZZZ | Расширенный формат ISO 8601 с часами, минутами и дополнительными полями секунд. Смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -04:00 |
x или X | ISO 8601 основной формат с полем часов и дополнительным мелким полем. Если вы задаете X, смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -04 |
xx или XX | ISO 8601 основной формат с часами и мелкими полями. Если вы задаете XX, смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -0400 |
xxx или XXX | Расширенный формат ISO 8601 с часами и мелкими полями. Если вы задаете XXX, смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -04:00 |
xxxx или XXXX | ISO 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(:,14),hwydata(:,4)); row = dataTipTextRow('State',statelabel); s.DataTipTemplate.DataTipRows(end+1) = row;
Измените формат для отображенных значений
Постройте график значений синуса. Добавьте третью строку во всплывающие подсказки по умолчанию, чтобы показать значения косинуса. Задайте числовой формат для отображенных значений косинуса. В этом случае используйте '%+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;
