Добавление строки в подсказки по данным
Используйте dataTipTextRow для создания новой строки подсказки данных с определенной меткой, источником значений и форматом значений. После создания новой строки подсказки данных ее необходимо присоединить к DataTipTemplate свойства выводимого на печать объекта.
Label - ЭтикеткаМетка, заданная как вектор символа или скаляр строки.
Пример: 'My Label'
Value - Источник стоимостиИсточник значений, указанный как вектор символов или строковый скаляр, содержащий имя свойства данных (например, 'XData'), имя рабочей области или переменной таблицы, вектор или дескриптор функции. Количество исходных значений должно соответствовать количеству точек данных.
Пример: 'XData' указывает источник значения в качестве XData свойства выводимого на печать объекта.
Пример: [1 2 3 4 5] указывает источник значений в качестве вектора.
Пример: @(x)sin(x) задает дескриптор функции, где x является XData значения объекта.
Пример: @(x,y)sin(y) задает дескриптор функции, где y является YData значения объекта.
Format - Формат значения'auto' (по умолчанию) | символьный вектор | строковый скалярФормат значения, указанный как 'auto' или вектор символов или строковый скаляр с числовым форматом, datetime или duration. Указанный тип формата должен соответствовать типу значений в 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. |
В этой таблице представлено несколько распространенных форматов и приведены примеры форматированных входных данных для даты: суббота, 19 апреля 2014 г., 9:41: 06.12345 в Нью-Йорке.
Значение 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) Unicode ® для дат.
Используйте идентификаторы в этой таблице, чтобы указать форматы отображения полей даты и времени.
| Буквенный идентификатор | Описание | Показ |
|---|---|---|
G | Эра | CE |
y | Год, без начальных нулей. См. примечание, следующее за этой таблицей. | 2014 |
yy | Год, используя последние две цифры. См. примечание, следующее за этой таблицей. | 14 |
yyy, yyyy ... | Год, используя по крайней мере количество цифр, указанное количеством экземпляров 'y' | За 2014 год, 'yyy' показы 2014, пока 'yyyyy' показы 02014. |
u, uu, ... | Год ИСО. Один номер, обозначающий год. Значение года 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, то pivot год определяет век, к которому принадлежит год.
Использовать один или несколько 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 или X | Основной формат ISO 8601 с полем часов и дополнительным полем минут. При указании X, смещение по времени, равное нулю, отображается как индикатор ISO 8601 UTC «Z». | -04 |
xx или XX | Основной формат ISO 8601 с полями часов и минут. При указании XX, смещение по времени, равное нулю, отображается как индикатор ISO 8601 UTC «Z». | -0400 |
xxx или XXX | Расширенный формат ISO 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);
Создайте линейный график с синусоидальными значениями. Добавьте третью строку в подсказки данных по умолчанию для отображения значений косинуса. Укажите числовой формат отображаемых косинусных значений. В этом случае используйте '%+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);
