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]. The 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 ')

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

Создайте простой линейный график и добавьте к рисунку аннотацию текстового поля. Задайте описание текста путем установки 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');

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

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

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

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

Создайте аннотацию текстового поля с многострочным текстом путем установки 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');

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

figure
plot(1:10)

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

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

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

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

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

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

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

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

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

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

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

свернуть все

Тип аннотации линии, заданный как одно из следующих значений.

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

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

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

Тип аннотации формы, заданный как одно из следующих значений.

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

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

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

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

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

Пример: x = [.3 .5]

Начальный и конечный y -cordinates, заданный как двухэлементный вектор вида [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 свойство

Пример: dim = [.3 .4 .5 .6]

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

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

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

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: annotation('rectangle',[.5 .5 .1 .1],'EdgeColor','r') создает прямоугольную аннотацию с красным контуром.

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

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

свернуть все

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

Первый входной параметрТип возвращенного объектаСтраница свойств
'line'ЛинияСвойства линии
'arrow'СтрелаСвойства стрелы
'doublearrow'Двойная стрелаСвойства DoubleEndArrow
'textarrow'Стрелка с текстомСвойства TextArrow
'textbox'Текстовое полеСвойства TextBox
'rectangle'ПрямоугольникСвойства прямоугольника
'ellipse'ЭллипсСвойства эллипса

Подробнее о

свернуть все

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

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

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