Расположение относительно осей, указанное как одно из значений расположения, перечисленных в этой таблице.

Пример: legend('Location','northeastoutside')

Ориентация, заданная как одно из следующих значений:

Пример: legend('Orientation','horizontal')

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

Используйте Orientation для управления отображением элементов условных обозначений в порядке следования по каждому столбцу или по каждой строке.

Пример: lgd.NumColumns = 3

Режим выбора для NumColumns значение, указанное как одно из следующих значений:

Пользовательское расположение и размер, заданный как четырехэлементный вектор формы [left bottom width height]. Первые два значения, left и bottomукажите расстояние от левого нижнего угла фигуры до левого нижнего угла легенды. Последние два значения, width и heightукажите размеры условных обозначений. Units свойство определяет единицы измерения позиции.

При указании Position , то MATLAB ® автоматически изменяет Location свойство для 'none'.

Пример: legend({'A','B'},'Position',[0.2 0.6 0.1 0.2])

Единицы измерения положения, указанные как одно из значений в этой таблице.

Все единицы измерения измеряются в левом нижнем углу окна контейнера.

Это свойство влияет на Position собственность. При изменении единиц измерения рекомендуется возвращать их значение по умолчанию после завершения вычислений, чтобы предотвратить воздействие на другие функции, предполагающие Units является значением по умолчанию.

При указании Position и Units свойства как Name,Value пары при создании объекта, то порядок спецификации имеет значение. Если требуется определить позицию с определенными единицами измерения, необходимо установить Units перед Position собственность.

Параметры компоновки, указанные как TiledChartLayoutOptions объект. Это свойство полезно, когда легенда находится в макете мозаичной диаграммы.

Чтобы расположить легенду в сетке разметки мозаичной диаграммы, установите Tile свойство на TiledChartLayoutOptions объект. Например, рассмотрим компоновку мозаичной диаграммы 3 на 3. Макет имеет сетку плиток в центре, и четыре плитки по внешним краям. На практике сетка невидима, и внешние плитки не занимают места, пока они не будут заполнены осями или другими объектами.

Этот код помещает легенду lgd в третьей плитке сетки..

lgd.Layout.Tile = 3;

Чтобы поместить легенду в одну из окружающих плиток, укажите Tile свойство как 'north', 'south', 'east', или 'west'. Например, установка значения 'east' помещает легенду в плитку справа от сетки.

lgd.Layout.Tile = 'east';

Если легенда не является потомком разметки мозаичной диаграммы (например, если она является потомком фигуры), то это свойство является пустым и не имеет эффекта.

Автоматическое обновление элементов условных обозначений для отражения текущего состояния осей, указанного как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Пример: legend({'A','B'},'AutoUpdate','off')

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

Заголовок легенды, возвращенный как текстовый объект легенды. Чтобы добавить заголовок легенды, установите String свойства текстового объекта легенды. Чтобы изменить внешний вид заголовка, например стиль или цвет шрифта, задайте свойства текста легенды. Список см. в разделе Свойства текста.

plot(rand(3));
lgd = legend('line 1','line 2','line 3');
lgd.Title.String = 'My Legend Title';
lgd.Title.FontSize = 12;

В качестве альтернативы используйте title для добавления заголовка и управления внешним видом.

plot(rand(3));
lgd = legend('line 1','line 2','line 3');
title(lgd,'My Legend Title','FontSize',12)

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

Разметка TeX

По умолчанию MATLAB поддерживает подмножество разметки TeX. Используйте разметку TeX для добавления надстрочных и подстрочных индексов, изменения типа и цвета шрифта и включения в текст специальных символов.

Модификаторы остаются в силе до конца текста. Надстрочные и подстрочные индексы являются исключением, поскольку они изменяют только следующий символ или символы в фигурных скобках. При установке для интерпретатора значения 'tex'поддерживаются следующие модификаторы.

В этой таблице перечислены поддерживаемые специальные символы для 'tex' переводчик.

Разметка LaTeX

Чтобы использовать разметку LaTeX, установите для интерпретатора значение 'latex'. Для встроенного режима окружить разметку однодолларовыми знаками ($). Для режима отображения обведите разметку двойными знаками доллара ($$).

'$\int_1^{20} x^2 dx$'

'$$\int_1^{20} x^2 dx$$'

В отображаемом тексте используется стиль шрифта LaTeX по умолчанию. FontName, FontWeight, и FontAngle свойства не имеют эффекта. Чтобы изменить стиль шрифта, используйте разметку LaTeX.

Максимальный размер текста, который можно использовать с интерпретатором LaTeX, составляет 1200 символов. Для многострочного текста это уменьшает приблизительно на 10 символов на строку.

Примеры использования TeX и LaTeX см. в разделе Греческие буквы и специальные символы в тексте диаграммы. Дополнительные сведения о системе LaTeX см. на веб-сайте проекта LaTeX по адресу https://www.latex-project.org/.

Имя шрифта, указанное как имя поддерживаемого шрифта или 'FixedWidth'. Для правильного отображения и печати текста необходимо выбрать шрифт, поддерживаемый системой. Шрифт по умолчанию зависит от операционной системы и языка.

Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любом языковом стандарте, используйте 'FixedWidth'. Шрифт фиксированной ширины зависит от корня FixedWidthFontName собственность. Установка корня FixedWidthFontName приводит к немедленному обновлению отображения для использования нового шрифта.

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

При изменении размера шрифта осей MATLAB автоматически устанавливает размер шрифта панели цветов равным 90% от размера шрифта осей. Если размер шрифта colorbar задается вручную, то изменение размера шрифта осей не влияет на шрифт colorbar.

Толщина символа, указанная как 'normal' или 'bold'.

MATLAB использует FontWeight для выбора шрифта из доступных в системе. Не все шрифты имеют жирный вес. Поэтому задание полужирного веса шрифта может привести к нормальному весу шрифта.

Наклон символа, указан как 'normal' или 'italic'.

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

Цвет текста, указанный как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя. Цвет по умолчанию - черный со значением [0 0 0].

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный цветовой код.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB, используемых на многих типах графиков.

Пример: [0 0 1]

Пример: 'blue'

Пример: '#0000FF'

Цвет фона, определяемый как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя. Значение по умолчанию [1 1 1] соответствует белому.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный цветовой код.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB, используемых на многих типах графиков.

Пример: legend({'A','B'},'Color','y')

Пример: legend({'A','B'},'Color',[0.8 0.8 1])

Пример: legend({'A','B'},'Color','#D9A2E9')

Цвет контура рамки, определяемый как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя. Значение по умолчанию [0.15 0.15 0.15] соответствует темно-серому.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный цветовой код.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB, используемых на многих типах графиков.

Пример: legend({'A','B'},'EdgeColor',[0 1 0])

Отображение контура ящика, указанного как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Пример: legend({'A','B'},'Box','off')

Ширина контура рамки, заданная как положительное значение в единицах измерения точки. Одна точка равна 1/72 дюйма.

Пример: 1.5

Состояние видимости, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Контекстное меню, указанное как ContextMenu объект. Это свойство используется для отображения контекстного меню при щелчке объекта правой кнопкой мыши. Создайте контекстное меню с помощью команды uicontextmenu функция.

Состояние выбора, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Отображение маркеров выбора при выборе, указанных как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Обратный вызов, выполняемый при щелчке элементов легенды, указанных как одно из следующих значений:

Если это свойство задается с помощью дескриптора функции, MATLAB передает Legend объект и структуру данных события в качестве первого и второго входных аргументов функции. В этой таблице описываются поля в структуре данных события.

Пример

Можно создать интерактивные легенды, чтобы при щелчке элемента в легенде связанная диаграмма каким-либо образом обновлялась. Например, можно переключить видимость диаграммы или изменить ее ширину. Установите ItemHitFcn свойство легенды для функции обратного вызова, которая управляет изменением диаграмм. В этом примере показано, как переключать видимость диаграммы при щелчке значка диаграммы или метки в легенде. Он создает функцию обратного вызова, которая изменяет Visible свойства диаграммы для 'on' или 'off'.

Скопируйте следующий код в новый файл функции и сохраните его как hitcallback_ex1.m либо в текущей папке, либо в папке на пути поиска MATLAB. Два входных аргумента, src и evnt, являются объектом легенды и структурой данных события. MATLAB автоматически передает эти входные данные функции обратного вызова при щелчке элемента легенды. Используйте Peer поле структуры данных события для доступа к свойствам объекта диаграммы, связанного с выбранным элементом легенды.

function hitcallback_ex1(src,evnt)

if strcmp(evnt.Peer.Visible,'on')
    evnt.Peer.Visible = 'off';
else 
    evnt.Peer.Visible = 'on';
end

end

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

plot(rand(4));
l = legend('Line 1','Line 2','Line 3','Line 4');
l.ItemHitFcn = @hitcallback_ex1;

Обратный вызов щелчком мыши, указанный как одно из следующих значений:

Это свойство используется для выполнения кода при щелчке по объекту. Если это свойство задается с помощью дескриптора функции, MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:

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

Функция создания объекта, заданная как одно из следующих значений:

Дополнительные сведения об указании обратного вызова в качестве дескриптора функции, массива ячеек или символьного вектора см. в разделе Определение обратного вызова.

Это свойство определяет функцию обратного вызова, выполняемую при создании объекта MATLAB. MATLAB инициализирует все значения свойств перед выполнением CreateFcn обратный вызов. Если не указать CreateFcn , то MATLAB выполняет функцию создания по умолчанию.

Установка CreateFcn свойство существующего компонента не оказывает никакого влияния.

Если это свойство указано как дескриптор функции или массив ячеек, можно получить доступ к объекту, создаваемому с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo для доступа к объекту.

Функция удаления объекта, заданная как одно из следующих значений:

Дополнительные сведения об указании обратного вызова в качестве дескриптора функции, массива ячеек или символьного вектора см. в разделе Определение обратного вызова.

Это свойство определяет функцию обратного вызова, выполняемую при удалении объекта MATLAB. MATLAB выполняет команду DeleteFcn обратный вызов перед уничтожением свойств объекта. Если не указать DeleteFcn , то MATLAB выполняет функцию удаления по умолчанию.

Если это свойство указано как дескриптор функции или массив ячеек, можно получить доступ к удаляемому объекту с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo для доступа к объекту.

Прерывание обратного вызова, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Это свойство определяет, можно ли прервать выполняющийся обратный вызов. Существует два состояния обратного вызова:

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов. Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание. Interruptible свойство имеет два возможных значения:

Очередь обратного вызова, указанная как 'queue' или 'cancel'. BusyAction определяет, как MATLAB обрабатывает выполнение прерывания обратных вызовов. Существует два состояния обратного вызова:

Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов. Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction свойство объекта, владеющего прерывистым обратным вызовом, определяет, отбрасывается он или помещается в очередь. Это возможные значения BusyAction свойство:

Возможность захвата щелчков мыши, указанных как одно из следующих значений:

Ответ на зафиксированные щелчки мыши, указанный как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Это свойство доступно только для чтения.

Состояние удаления, возвращаемое как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.

MATLAB устанавливает BeingDeleted свойство для 'on' когда DeleteFcn обратный вызов начинает выполнение. BeingDeleted свойство остается установленным в значение 'on' до тех пор, пока объект-компонент больше не будет существовать.

Проверьте значение BeingDeleted для проверки того, что объект не будет удален перед запросом или изменением.

Родительский контейнер, указанный как Figure объект, Panel объект, Tab объект или TiledChartLayout объект.

Legend объект должен иметь тот же родительский элемент, что и связанные оси. При изменении родителя связанных осей Legend объект автоматически обновляется для использования одного и того же родителя.

Объект не имеет дочерних элементов. Невозможно задать это свойство.

Видимость дескриптора объекта в Children свойство родительского объекта, указанное как одно из следующих значений:

Если объект не указан в списке Children свойства родительского объекта, то функции, которые получают дескрипторы объектов путем поиска в иерархии объектов или запроса свойств дескрипторов, не могут вернуть его. Примеры таких функций включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close функции.

Дескрипторы скрытых объектов по-прежнему действительны. Установка корня ShowHiddenHandles свойство для 'on' перечисление всех дескрипторов объектов независимо от их HandleVisibility параметр свойства.

Это свойство доступно только для чтения.

Тип графического объекта, возвращаемого как 'legend'. Это свойство используется для поиска всех объектов данного типа в иерархии печати.

Идентификатор объекта, заданный как вектор символа или скаляр строки. Можно указать уникальный Tag для использования в качестве идентификатора объекта. При необходимости доступа к объекту в другом месте кода можно использовать findobj для поиска объекта на основе Tag значение.

Пользовательские данные, указанные как любой массив MATLAB. Например, можно указать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Это свойство используется для хранения произвольных данных объекта.

Если вы работаете в App Designer, создайте открытые или частные свойства в приложении для совместного использования данных вместо использования UserData собственность. Дополнительные сведения см. в разделе Общий доступ к данным в приложениях App Designer.