exponenta event banner

Свойства TiledChartLayout

Внешний вид и поведение разметки мозаичной диаграммы

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

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

Расположение

развернуть все

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

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

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

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

  • 'fixed' - Формат имеет фиксированное количество строк и столбцов, определяемое GridSize собственность. Один mоколо-n компоновка с таким расположением плиток может отображать до m*n участки.

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

MATLAB устанавливает значение этого свойства равным 'fixed' при установке вручную GridSize собственность.

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

В этой таблице показано, как каждое значение влияет на внешний вид 2около-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около-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')

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

Примечание

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)

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

Примечание

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)

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

Примечание

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

Положение

развернуть все

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

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

  • 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 собственность.

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

  • 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'- OuterPosition свойство остается постоянным при добавлении, удалении или изменении декораций, таких как заголовок или метка оси. При необходимости регулировки положения MATLAB корректирует InnerPosition собственность.

  • 'innerposition'- 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

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

  • Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

  • Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.

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

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

  • 'queue' - помещает обратный вызов с прерыванием в очередь, подлежащую обработке после завершения выполнения обратного вызова.

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

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

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

MATLAB устанавливает BeingDeleted свойство для 'on' когда DeleteFcn обратный вызов начинает выполнение. 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