TiledChartLayout Properties

Внешний вид и поведение размещения графика

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

t = tiledlayout(2,2);
t.TileSpacing = 'compact';

Размещение

расширить все

Размер сетки, заданный как вектор формы [m n], где m количество строк и n количество столбцов. Задать это свойство можно только тогда, когда все плитки в размещении пусты. Когда вы устанавливаете это свойство, MATLAB® устанавливает TileArrangement свойство к 'fixed'.

Значение этого свойства может автоматически измениться для размещений с TileArrangement значение свойства установлено в 'flow'. Например, если размер родительского контейнера изменяется или изменяется количество осей в размещении, размер сетки обновляется, чтобы учесть эти изменения.

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

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

  • 'fixed' - размещение имеет фиксированное количество строк и столбцов, определяемое GridSize свойство. Система координат m-by- n размещение с этим расположением плитки может отображать до m*n графики.

  • 'flow' - размещение имеет переменное количество строк и столбцов, которые могут отображать любое количество графиков. Каждый раз, когда вы звоните nexttileКомпоновка переплетается по мере необходимости для размещения новых осей с сохранением соотношения сторон приблизительно 4:3 для всех плиток.

MATLAB задает значение этого свойства 'fixed' если вы вручную установите GridSize свойство.

Интервал между плитками, заданный как 'loose', 'compact', 'tight' или 'none'. Используйте это свойство для управления интервалом между плитками.

В этой таблице показано, как каждое значение влияет на внешний вид 2-by- 2 размещение.

ЗначениеВнешность

'loose'

Tiled chart layout with 'loose' tile spacing.

'compact'

Tiled chart layout with 'compact' tile spacing.

'tight'

Tiled chart layout with 'tight' tile spacing.

'none'

Tiled chart layout with 'none' tile spacing.

Заполнение по периметру размещения, заданное как 'loose', 'compact', или 'tight'. Размещение предоставляет пространство для всех украшений, таких как подписи по осям, независимо от значения этого свойства.

В этой таблице показано, как каждое значение влияет на внешний вид 2-by- 2 размещение.

ЗначениеВнешность

'loose'

Tiled chart layout with 'loose' padding.

'compact'

Tiled chart layout with 'compact' padding.

'tight'

Tiled chart layout with 'tight' padding.

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

ЗначениеОписание
'rowmajor'

Номера плитки увеличиваются по строкам слева направо. Для примера этот рисунок показывает индексы основной мозаики строк для размещения 2 на 2.

'columnmajor'

Номера плитки увеличиваются вниз по столбцам. Для примера этот рисунок показывает индексы основной плитки столбца для размещения 2 на 2.

Метки

расширить все

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

t = tiledlayout(2,2);
t.Title.String = 'My Title';
t.Title.FontWeight = 'bold';

Также передайте TiledChartLayout объект для title функция.

title(t,'My Title','FontWeight','normal')

Полный список свойств, которые можно задать, см. в разделе Свойства текста.

Примечание

The Text объект не содержится в Children свойство размещения, поэтому оно не может быть возвращено findobj функция.

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

t = tiledlayout(2,2);
t.Subtitle.String = 'An Insightful Subtitle';
t.Subtitle.FontAngle = 'italic';

Кроме того, subtitle функция для добавления субтитра и управления внешним видом.

subtitle('An Insightful Subtitle','FontAngle','italic')

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

[tt,s] = title(t,'Clever Title','An Insightful Subtitle');
s.FontAngle = 'italic';

Примечание

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

Text объект для общей метки x -оси. Чтобы добавить общую метку x -ось, установите String свойство текстового объекта. Чтобы изменить внешний вид метки, например размер шрифта, задайте другие свойства. Например, создайте общую метку x -ось с 14-точечным шрифтом для размещения 2 на 2 .

t = tiledlayout(2,2);
t.XLabel.String = 'My x-Axis Label';
t.XLabel.FontSize = 14;

Также передайте TiledChartLayout объект для xlabel функция.

xlabel(t,'My x-Axis Label','FontSize',14)

Полный список свойств, которые можно задать, см. в разделе Свойства текста.

Примечание

The Text объект не содержится в осях Children свойство, поэтому оно не может быть возвращено findobj.

Text объект для общей метки y -оси. Чтобы добавить общую метку y -ось, установите String свойство текстового объекта. Чтобы изменить внешний вид метки, например размер шрифта, задайте другие свойства. Например, создайте общую метку y -ось с 14-точечным шрифтом для размещения 2 на 2 .

t = tiledlayout(2,2);
t.YLabel.String = 'My y-Axis Label';
t.YLabel.FontSize = 14;

Также передайте TiledChartLayout объект для ylabel функция.

ylabel(t,'My y-Axis Label','FontSize',14)

Полный список свойств, которые можно задать, см. в разделе Свойства текста.

Примечание

The Text объект не содержится в осях Children свойство, поэтому оно не может быть возвращено findobj.

Положение

расширить все

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

  • The left и bottom элементы определяют расстояние от нижнего левого угла контейнера (обычно рисунок, панель или вкладка) до нижнего левого угла контура положения.

  • The width и height элементы являются размерностями контура внешнего положения.

В следующем размещении синий прямоугольник представляет OuterPosition свойство, и красный прямоугольник представляет InnerPosition и Position свойства (которые имеют то же значение).

2-by-2 layout with a blue rectangle that surrounds the four axes and labels. A red rectangle surrounds the four plot boxes only.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

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

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

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

  • The left и bottom элементы определяют расстояние от нижнего левого угла контейнера (обычно рисунок, панель или вкладка) до нижнего левого угла контура положения.

  • The width и height элементы являются размерностями контуров положения. Для осей на 3-D виде Position свойство является наименьшим прямоугольником, который окружает оси.

В следующем размещении синий прямоугольник представляет OuterPosition свойство, и красный прямоугольник представляет InnerPosition и Position свойства (которые имеют то же значение).

2-by-2 layout with a blue rectangle that surrounds the four axes and labels. A red rectangle surrounds the four plot boxes only.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

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

  • 'outerposition' - The OuterPosition свойство остается постоянным, когда вы добавляете, удаляете или изменяете украшения, такие как заголовок или подпись по осям. Если необходимы какие-либо корректировки положения, MATLAB настраивает InnerPosition свойство.

  • 'innerposition' - The InnerPosition свойство остается постоянным, когда вы добавляете, удаляете или изменяете украшения, такие как заголовок или подпись по осям. Если необходимы какие-либо корректировки положения, MATLAB настраивает OuterPosition свойство.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Позиционные модули, заданные как одно из значений в этой таблице.

UnitsОписание
'normalized' (по умолчанию)Нормирован относительно родительского контейнера, который обычно является рисунком. Нижний левый угол рисунка преобразуется в (0,0) и правый верхний угол преобразуется в (1,1).
'inches'Дюймы.
'centimeters'Сантиметры.
'characters'

На основе размера символа системного шрифта по умолчанию.

  • Ширина символа = ширина буквы x.

  • Высота символа = расстояние между базовыми линиями двух строк текста.

'points'Точки. Одна точка равна 1/72 дюйма.
'pixels'

Пиксели.

  • В Windows® систем, пиксель составляет 1/96 дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

  • На Linux® систем, размер пикселя определяется вашим системным разрешением.

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

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

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

Опции размещения, заданные как TiledChartLayoutOptions объект или GridLayoutOptions объект. Используйте это свойство для позиционирования вложенного размещения в родительском размещении. Например, чтобы расположить размещение внутри другого размещения мозаичного графика, установите Tile и TileSpan свойства на TiledChartLayoutOptions объект.

Для примера этот код позиционирует layout2 в третью плитку layout1.

layout1 = tiledlayout(2,2);
layout2 = tiledlayout(layout1,1,3);
layout2.Layout.Tile = 3;

Чтобы сделать вложенное размещение охватывающим несколькими плитками, задайте TileSpan свойство как двухэлементный вектор. Для примера этот код охватывает layout2 по одной строке и двум столбцам мозаик.

layout2.Layout.TileSpan = [1 2];
Если вы заполняете все плитки в обоих размещениях, составное размещение выглядит следующим образом:

2-by-2 layout with a nested 1-by-3 layout in the second row.

Чтобы поместить размещение в сетку размещения в приложении, задайте это свойство как GridLayoutOptions объект. Для получения дополнительной информации о работе с размещениями сетки в приложениях, см. uigridlayout.

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

Интерактивность

расширить все

Разделяемые данные, заданная как AxesToolbar объект, возвращенный axtoolbar функция. Панель инструментов появится в правом верхнем углу размещения при наведении указателя мыши на нее.

По умолчанию общая панель инструментов отсутствует, и каждый из отдельных объектов осей имеет свою собственную панель инструментов. Когда Вы создаете общую панель инструментов, панели инструментов на отдельных объектах осей становятся скрытыми. Если вы не хотите никаких панелей инструментов в размещении, оставьте это свойство пустым и установите Visible свойство AxesToolbar объект к 'off' для каждой оси.

t = tiledlayout(2,1);
ax = nexttile;
ax.Toolbar.Visible = 'off';

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

  • 'on' - Отобразите объект.

  • 'off' - Скрыть объект, не удаляя его. Вы по-прежнему можете получить доступ к свойствам невидимого объекта.

Коллбэки

расширить все

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

  • Указатель на функцию.

  • Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.

Для получения дополнительной информации об указании коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Определение коллбэка».

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

Установка CreateFcn свойство в существующем компоненте не имеет никакого эффекта.

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

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

  • Указатель на функцию.

  • Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.

Для получения дополнительной информации об указании коллбэка как указателя на функцию, массива ячеек или вектора символов, см. Раздел «Определение коллбэка».

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

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

Контроль выполнения обратного вызова

расширить все

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

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

  • Обратный коллбэк running - это актуальный на данный момент коллбэк.

  • Обратный коллбэк interrupting - это коллбэк, который пытается прервать текущий коллбэк.

Всякий раз, когда MATLAB вызывает коллбэк, этот коллбэк пытается прервать текущий коллбэк (если он существует). The Interruptible свойство объекта, имеющего текущий коллбэк, определяет, разрешено ли прерывание.

  • Значение 'on' позволяет другим коллбэкам прерывать коллбэки объекта. Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь, например, когда есть drawnow, figure, uifigure, getframe, waitfor, или pause команда.

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

    • Если текущий коллбэк не содержит одну из этих команд, MATLAB завершает выполнение коллбэка без прерывания.

  • Значение 'off' блокирует все попытки прерывания. The BusyAction свойство объекта, имеющего прерывание обратного вызова, определяет, отменяется ли прерывание обратного вызова или помещается в очередь.

Примечание

Прерывание и выполнение коллбэка происходят по-разному в таких ситуациях:

  • Если прерывание обратного вызова является DeleteFcn, CloseRequestFcn или SizeChangedFcn коллбэк, тогда прерывание происходит независимо от Interruptible значение свойства.

  • Если текущий коллбэк выполняющегося в данного момента, waitfor function, тогда прерывание происходит независимо от Interruptible значение свойства.

  • Timer объекты выполняются в соответствии с расписанием независимо от Interruptible значение свойства.

Когда происходит прерывание, MATLAB не сохраняет состояние свойств или отображения. Для примера, объект, возвращенный gca или gcf команда может измениться при выполнении другого коллбэка.

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

  • Обратный коллбэк running - это актуальный на данный момент коллбэк.

  • Обратный коллбэк interrupting - это коллбэк, который пытается прервать текущий коллбэк.

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

  • 'queue' - помещает прерывание обратного вызова в очередь вызовов, подлежащих обработке после концов обратного коллбэка.

  • 'cancel' - Не выполняет прерывание обратного вызова.

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

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

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

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

Родитель/ребенок

расширить все

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

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

Вы не можете добавить или удалить дочерние элементы, используя Children свойство. Чтобы добавить дочерний элемент в этот список, установите Parent свойство дочернего графического объекта к TiledChartLayout объект.

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

  • 'on' - указатель на объект всегда отображается.

  • 'off' - указатель на объект всегда невидим. Эта опция используется для предотвращения непреднамеренных изменений другой функцией. Установите HandleVisibility на 'off' временно скрыть указатель во время выполнения этой функции.

  • 'callback' - Указатель на объект виден из коллбэков или функций, вызываемых коллбэками, но не из функций, инициируемых из командной строки. Эта опция блокирует доступ к объекту в командной строке, но позволяет функциям обратного вызова обращаться к нему.

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

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

Идентификаторы

расширить все

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

Тип графического объекта, возвращенный как 'tiledlayout'.

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

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

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

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

расширить все

Поведение изменено в R2021a

См. также

|

Введенный в R2019b