exponenta event banner

аннотация

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

Описание

пример

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

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

Пример: 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'Двойная стрелкаСвойства DouureEndArrow
'textarrow'Текстовая стрелкаСвойства TextArrow
'textbox'Текстовое полеСвойства TextBox
'rectangle'ПрямоугольникСвойства прямоугольника
'ellipse'ЭллипсСвойства эллипса

Подробнее

свернуть все

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

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

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