аннотация

Создайте аннотации

Синтаксис

annotation(lineType,x,y)
annotation(lineType)
annotation(shapeType,dim)
annotation(shapeType)
annotation(___,Name,Value)
annotation(container,___)
an = annotation(___)

Описание

пример

annotation(lineType,x,y) создает строку или расширение аннотации стрелки между двумя точками в текущей фигуре. Задайте lineType как 'line', 'arrow', 'doublearrow' или 'textarrow'. Задайте x и y как двухэлементные векторы формы [x_begin x_end] и [y_begin y_end], соответственно.

annotation(lineType) создает аннотацию в положении по умолчанию между точками (0.3,0.3) и (0.4,0.4).

пример

annotation(shapeType,dim) создает прямоугольник, эллипс или аннотацию текстового поля с конкретным размером и местоположением в текущей фигуре. Задайте shapeType как 'rectangle', 'ellipse' или 'textbox'. Задайте dim как четырехэлементный вектор формы [x y w h]. x и элементы y определяют положение и w, и элементы h определяют размер.

annotation(shapeType) создает аннотацию в положении по умолчанию так, чтобы левый нижний угол был в (0.3,0.3), и шириной и высотой является оба 0.1.

пример

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

annotation(container,___) создает аннотацию в фигуре, uipanel, или uitab, заданный container, вместо в текущей фигуре.

пример

an = annotation(___) возвращает объект пометок. Тип возвращенного объекта зависит от первого входного параметра. Используйте an, чтобы изменить свойства объекта после того, как это будет создано. Можно задать выходной аргумент с любым из предыдущих синтаксисов.

Примеры

свернуть все

Постройте простой график и добавьте стрелку с текстом к фигуре. Задайте местоположение стрелки с текстом в нормализованных координатах фигуры, запускающихся в точке (0.3,0.6) и заканчивающихся в (0.5,0.5). Задайте текстовое описание путем установки свойства String.

figure
plot(1:10)
x = [0.3 0.5];
y = [0.6 0.5];
annotation('textarrow',x,y,'String','y = x ')

Постройте простой график и добавьте аннотацию текстового поля к фигуре. Задайте текстовое описание путем установки свойства String. Обеспечьте поле, чтобы соответствовать плотно вокруг текста путем установки свойства FitBoxToText на 'on'.

figure
plot(1:10)
dim = [.2 .5 .3 .3];
str = 'Straight Line Plot from 1 to 10';
annotation('textbox',dim,'String',str,'FitBoxToText','on');

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

figure
plot(1:10)
dim = [.2 .5 .3 .3];
str = 'Straight Line Plot from 1 to 10';
annotation('textbox',dim,'String',str)

Создайте аннотацию текстового поля с многострочным текстом путем установки свойства String на массив ячеек. Каждый элемент массива ячеек отображается на отдельной строке. Обеспечьте поле, чтобы соответствовать плотно вокруг текста путем установки свойства FitBoxToText на 'on'.

figure
plot(1:10)
dim = [0.2 0.5 0.3 0.3];
str = {'Straight Line Plot','from 1 to 10'};
annotation('textbox',dim,'String',str,'FitBoxToText','on');

Создайте диаграмму стебель-листья и добавьте прямоугольную аннотацию к фигуре. Измените цвет прямоугольной схемы путем определения свойства Color.

figure
data = [2 4 6 7 8 7 5 2];
stem(data)
dim = [.3 .68 .2 .2];
annotation('rectangle',dim,'Color','red')

Добавьте вторую прямоугольную аннотацию к фигуре. Задайте цвет заливки путем установки свойства FaceColor. Добавьте прозрачность путем установки свойства FaceAlpha на значение между 0 (абсолютно прозрачный) и 1 (абсолютно непрозрачный).

dim2 = [.74 .56 .1 .1];
annotation('rectangle',dim2,'FaceColor','blue','FaceAlpha',.2)

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

figure
x = linspace(-4,4);
y = x.^3 - 12*x;
plot(x,y)

dim = [.2 .74 .25 .15];
annotation('ellipse',dim)

Чертите красный прямоугольник с помощью тех же размерностей, чтобы показать, как эллипс заполняет прямоугольную область.

annotation('rectangle',dim,'Color','red')

Постройте простой график. Затем добавьте стрелку углом к графику путем объединения строки и аннотации стрелки.

figure
plot(1:10)

xl = [.3 .3];
yl = [.3 .4];
annotation('line',xl,yl)

xa = [.3 .4];
ya = [.4 .4];
annotation('arrow',xa,ya)

Добавьте стрелку с текстом к фигуре и возвратите объект стрелки с текстом аннотации, a.

figure
plot(1:10)
x = [0.3,0.5];
y = [0.6,0.5];
a = annotation('textarrow',x,y,'String','y = x ');

Измените свойства стрелки с текстом аннотации с помощью a. Например, измените цвет на красный и размер шрифта к 14 точкам.

a.Color = 'red';
a.FontSize = 14;

Смотрите страницы свойств аннотации для списка свойств для каждого типа аннотации.

Входные параметры

свернуть все

Тип аннотации строки, заданной как одно из этих значений.

ЗначениеТип объектаПример
строкаСтрока аннотацииannotation('line',[.1 .2],[.1 .2])
СтрелкаСтрелка аннотацииannotation('arrow',[.1 .2],[.1 .2])
'doublearrow'Двойная стрелка аннотацииannotation('doublearrow',[.1 .2],[.1 .2])
'textarrow'

Стрелка с текстом аннотации. Чтобы добавить текст к заключительной части стрелки с текстом, используйте свойство String.

annotation('textarrow',[.1 .2],[.1 .2],'String','my text')

Тип аннотации формы, заданной как одно из этих значений.

ЗначениеТип объектаПример
прямоугольникПрямоугольник аннотацииannotation('rectangle',[.2 .3 .4 .5])
'ellipse'Эллипс аннотацииannotation('ellipse',[.2 .3 .4 .5])
Текстовое поле

Текстовое поле Annotation. Чтобы задать текст, установите свойство String. Чтобы автоматически настроить размерности поля, чтобы плотно прилегать вокруг текста, установите свойство FitBoxToText на 'on'.

annotation('textbox',[.2 .3 .4 .5],'String','my text','FitBoxToText','on')

Начало и конечные x-координаты, заданные как двухэлементный вектор формы [x_begin x_end]. Вместе x и входные параметры y определяют конечные точки строки, стрелка, двойная стрелка или аннотация стрелки с текстом. Аннотация расширяет от точки (x_begin, y_begin) к (x_end, y_end).

По умолчанию модули нормализованы фигуре. Левый нижний угол фигуры сопоставляет с (0,0), и правый верхний угол сопоставляет с (1,1). Для изменения единиц используйте свойство Units.

Пример: x = [.3.5]

Начало и конечные y-координаты, заданные как двухэлементный вектор формы [y_begin y_end]. Вместе x и входные параметры y определяют конечные точки строки, стрелка, двойная стрелка или аннотация стрелки с текстом. Аннотация расширяет от точки (x_begin, y_begin) к (x_end, y_end).

По умолчанию модули нормализованы фигуре. Левый нижний угол фигуры сопоставляет с (0,0), и правый верхний угол сопоставляет с (1,1). Для изменения единиц используйте свойство Units.

Пример: y = [.3.5]

Размер и местоположение, заданное как четырехэлементный вектор формы [x y w h]. Первые два элемента задают координаты левого нижнего угла текстового поля, прямоугольника или эллипса относительно левого нижнего угла фигуры. Вторые два элемента задают ширину и высоту аннотации, соответственно.

Если вы создаете эллипс, то dim является размером и местоположением наименьшего прямоугольника, который заключает эллипс.

По умолчанию модули нормализованы фигуре. Левый нижний угол фигуры сопоставляет с (0,0), и правый верхний угол сопоставляет с (1,1). Для изменения единиц используйте свойство Units

Пример: потускнейте = [.3.4.5.6]

Цель для аннотации, заданной как фигура, uipanel, или объект uitab. Например, чтобы добавить аннотацию к определенной фигуре, задайте объект фигуры как первый входной параметр к функции.

f = figure;
annotation(f,'line',[.1 .2],[.2 .3])

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: аннотация ('прямоугольник', [.5.5.1.1], 'EdgeColor', 'r') создает прямоугольную аннотацию с красной схемой.

Каждый тип объекта пометок поддерживает различный набор свойств. Для полного списка свойств и описаний для каждого типа, смотрите связанную страницу свойств.

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

свернуть все

Объект аннотации, возвращенный как скаляр. Тип возвращенного объекта пометок зависит от первого входного параметра.

Первый входной параметрТип объекта возвращенСтраница свойств
строкаСтрокаLine Properties
СтрелкаСтрелкаArrow Properties
'doublearrow'Двойная стрелкаDoubleEndArrow Properties
'textarrow'Стрелка с текстомTextArrow Properties
Текстовое полеТекстовое полеTextBox Properties
прямоугольникПрямоугольникСвойства прямоугольника
'ellipse'ЭллипсEllipse Properties

Больше о

свернуть все

Вопросы совместимости

Начиная в R2014b, аннотации не могут пересечь uipanel контуры. Вместо этого они отсекают на контурах. Предыдущие версии MATLAB® позволяют аннотациям расширять в (или из) контуры. Чтобы отобразить аннотацию в определенной фигуре, uipanel, или uitab, используют входной параметр container.

Представлено до R2006a

Была ли эта тема полезной?