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

Легенда Пример: ('Местоположение', 'northeastoutside')

Ориентация, заданная как одно из этих значений:

Легенда Пример: ('Ориентация', 'горизонталь')

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

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

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

Режим выбора для значения NumColumns, заданного как одно из этих значений:

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

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

Легенда Пример: ({, 'B'} ', Положение', [0.2 0.6 0.1 0.2])

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

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

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

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

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

Легенда Пример: ({, 'B'} ', AutoUpdate', 'off')

Текст для меток легенды, заданных как массив ячеек из символьных векторов или массив строк.

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

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 Markup

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

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

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

Разметка LaTeX

Чтобы использовать разметку LATEX, установите свойство Interpreter на 'latex'. Используйте долларовые символы вокруг текста, например, используйте '$\int_1^{20} x^2 dx$' для встроенного режима или '$$\int_1^{20} x^2 dx$$' для режима отображения.

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

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

Для получения дополнительной информации о системе LATEX, смотрите веб-сайт Проекта LATEX по https://www.latex-project.org/.

Название шрифта, заданное как поддерживаемое название шрифта или 'FixedWidth'. Чтобы отобразить и распечатать текст правильно, необходимо выбрать шрифт, который поддерживает система. Стандартный шрифт зависит от вашей операционной системы и локали.

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

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

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

Символьная толщина, заданная как 'normal' или 'bold'.

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

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

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

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

Для пользовательского цвета укажите триплет RGB. Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7]. Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены варианты длинного и краткого наименований цветов и их эквивалентные значения RGB.

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

Пример: 'blue'

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

Для пользовательского цвета укажите триплет RGB. Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7]. Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены варианты длинного и краткого наименований цветов и их эквивалентные значения RGB.

Легенда Пример: ({, 'B'} ', Цвет', 'y')

Легенда Пример: ({, 'B'} ', Цвет', [0.8 0.8 1])

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

Для пользовательского цвета укажите триплет RGB. Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7]. Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены варианты длинного и краткого наименований цветов и их эквивалентные значения RGB.

Легенда Пример: ({, 'B'} ', EdgeColor', [0 1 0])

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

Легенда Пример: ({, 'B'} ', Поле', 'off')

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

Пример 1. 5

Состояние видимости, заданное в качестве одного из следующих значений:

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

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

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

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

Если вы задаете это свойство с помощью указателя на функцию, то 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 выполняет обратный вызов после создания объекта и настройки всех его свойств. Установка значения свойства CreateFcn не влияет на существующий объект . Для того, чтобы действие было эффективным, вам необходимо задать свойство CreateFcn во время создания объекта. Один из способов задать свойство во время создания объекта — задать значение свойства по умолчанию для объекта. Для получения дополнительной информации см. Раздел "Значения свойств по умолчанию".

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

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

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

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

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

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

Прерывание обратного вызова, заданное как 'off' или 'on'. Свойство «Прерывание» определяет, можно ли прерывать выполняемый обратный вызов.

Рассмотрите эти состояния обратного вызова где:

Каждый раз, когда MATLAB инициирует обратный вызов, этот обратный вызов пытается прервать текущий обратный вызов. Прерываемое свойство объекта, владеющего рабочим обратным вызовом, определяет, разрешено ли прерывание. Свойство «Прерывание» имеет два возможных значения:

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

Рассмотрите эти состояния обратного вызова где:

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

Если обратный вызов объекта Legend пытается прервать рабочий обратный вызов, который не может быть прерван, то свойство BusyAction определяет, отбрасывается ли это или вставило очередь. Задайте свойство BusyAction как одно из следующих значений:

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

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

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

Удаление статуса, возврат на 'off' или 'on'. MATLAB устанавливает свойство BeingDeleted на 'on', когда функция удаления объекта начинает выполняться (см. ""Свойство DeleteFcn""). Свойство BeingDeleted остается в установленном значении 'on', до того момента, как объект перестанет существовать.

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

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

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

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

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

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

Скрытые указатели на объекты все еще действительны. Установите значение корневого свойства ShowHiddenHandles на 'on', чтобы отобразить все указатели на объекты независимо от значения свойства HandleVisibility.

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

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

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

Используйте это свойство найти объекты legend в иерархии. Например, можно использовать функцию findobj, чтобы найти объекты legend, которые имеют определенное значение свойства Tag.

Пример: 'Данные в январе'

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

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

Пример: 1:100